# 生成工单 GitHub Issue 草稿

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

从工单结构化事实生成可核对的标题和正文；本动作不提交外部 Issue。

```text
POST https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/{id}/github-issue-draft
```

## 调用前准备

准备当前环境可用的 Genesis 管理员 Bearer；普通个人访问令牌、X-API-Key 和工作区 Owner 不能替代。会话模式的写操作另需 CSRF。参见[AI Studio](../../../../../developer/api/ai-studio/index.md)。示例 ID 需换为获准查看的真实工单 ID。

草稿从标题、问题、期望、实际、复现、建议优先级和反馈编号生成；不复制完整 messages、管理员回复或用户目录信息。正文受当前本地化模板影响，示例仅展示一组输入的结果。检测与替换不保证覆盖全部敏感内容，提交前仍需人工核对。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X POST "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/ticket-example/github-issue-draft" \
  -H "Authorization: Bearer $GENESIS_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"kind":"bug"}'
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `Authorization` | string | Bearer示例是 | Bearer 加当前环境可信管理员令牌；不要同时设置 API Key。 |
| `id` | string | 是 | 路径工单 ID。 |
| `kind` | string | 是 | bug、feature 或 auto。省略/空值不自动选 auto。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": 0,
  "data": {
    "kind": "bug",
    "template": "moi-bug",
    "title": "[MOI BUG] 示例反馈",
    "body": "本 Issue 基于管理员提交的 MatrixFlow Feedback Ticket 事实创建。\n\n## 问题描述\n\n界面显示结果与预期不同。\n\n## 期望行为\n\n待确认\n\n## 实际行为\n\n待确认\n\n## 复现步骤\n\n待确认\n\n## 用户建议优先级（仅供分诊参考）\n\n待确认\n\n## 内部反馈编号\n\nFB-EXAMPLE\n\n<!-- matrixflow-feedback-ticket:ticket-example -->",
    "sensitive_findings": []
  }
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | integer | 成功为数字 0。 |
| `data` | object | 生成的草稿。 |
| `data.kind` | string | bug、feature 或 auto；创建策略，不等同最终 GitHub Type。 |
| `data.template` | string | 当前模板标识 moi-bug、moi-feature 或 moi-auto。 |
| `data.title` | string | 生成的草稿标题，包含当前类型的前缀。 |
| `data.body` | string | 生成的 Markdown 草稿正文，需人工核对；不包含完整工单对话。 |
| `data.sensitive_findings` | string（字符串数组） | 检测到的类别数组；当前已知 token、credential、temporary_url、personal_data、business_data，不代表穷尽所有敏感内容。 |

嵌套工单、用户、消息、审批事实和 GitHub 请求的全部公开字段见[公共对象](objects.md)。字段可空与可省略分别列明，不把旧 SDK fixture 的 submitter_email 当作当前字段。
:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{"code":"Unauthorized","msg":"Unauthorized"}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string / integer | 随失败阶段而异；示例为认证层字符串。 |
| `msg` | string | 认证或服务层失败文本，服务层通常本地化。 |
| `message` | string | 参数解析阶段数字错误码的文本；与 msg 区分。 |
| `data` | null | 当前服务层 responseEnvelope 错误保留 null；认证示例可不含此字段。 |
| `details` | object | 文本字段 422 错误可带 field/reason 等，见错误说明。 |

| HTTP / code | 条件与处理 |
| --- | --- |
| 401 / Unauthorized | 认证层拒绝；不要使用普通 PAT 或同时带 X-API-Key。 |
| 403 / ErrForbidden | 未取得可信管理员事实，或当前调用身份与管理员事实不匹配。 |
| 404 / ErrFeedbackTicketNotFound | 目标工单不存在；当前 service 错误返回 code/msg/data:null。 |
| 503 / ErrServiceUnavailable | 已分类的身份、目录、授权依赖不可用或网络超时。 |
| 500 / ErrServer | 内部处理或本地化失败；写请求错误后先回读确认。 |
| 400 / ErrFeedbackGitHubIssueDraftInvalid | kind 或 JSON 结构不合法。 |
| 422 / ErrFieldRequired 或 ErrFieldTooLong | 最终标题或正文为空/超长；详细字段位置与 Unicode 计数见错误说明。 |

完整错误族与各阶段见[错误和恢复](errors-recovery.md)。
:::::
::::::
:::::::
