提交工单 GitHub Issue 创建请求¶
将已核对的草稿排队创建外部 Issue;收到202后需回查工单中的 GitHub 状态。
POST https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/{id}/github-issue
调用前准备¶
准备当前环境可用的 Genesis 管理员 Bearer;普通个人访问令牌、X-API-Key 和工作区 Owner 不能替代。会话模式的写操作另需 CSRF。参见AI Studio。示例 ID 需换为获准查看的真实工单 ID。
会触发后续对外创建,真实验证须另有明确的外部发布授权。已有 created 返回原结果;pending/creating 拒绝重复,failed 需 retry:true。输入合法性和敏感内容检测在已有结果返回前仍会执行。列表可用标志只由配置决定,实际执行身份、绑定和工具仍需验证。
请求参数¶
curl -X POST "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/ticket-example/github-issue" \
-H "Authorization: Bearer $GENESIS_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
--data '{"kind":"bug","title":"示例问题","body":"已核对的问题描述。","retry":false}'
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
Bearer示例是 |
Bearer 加当前环境可信管理员令牌;不要同时设置 API Key。 |
|
string |
是 |
路径工单 ID。 |
|
string |
是 |
bug、feature 或 auto,表示创建策略。 |
|
string |
是 |
去前后空白后非空,最多256个 Unicode 码点。 |
|
string |
是 |
移除旧反馈标记、trim并附加当前标记后非空,最终最多65536个 Unicode 码点。 |
|
boolean |
否 |
默认false;只有失败请求允许显式重试,重新冻结内容并生成新 request_id。 |
成功响应¶
{
"code": 0,
"data": {
"ticket_id": "ticket-example",
"kind": "bug",
"status": "pending",
"draft_title": "示例问题",
"draft_body": "已核对的问题描述。\n\n<!-- matrixflow-feedback-ticket:ticket-example -->",
"request_id": "request-example",
"requested_by": "admin-example",
"attempt_count": 0,
"last_attempt_at": null,
"issue_number": null,
"issue_url": null,
"created_by": "",
"issue_created_at": null,
"last_error_code": "",
"created_at": "2026-11-12T04:00:00Z",
"updated_at": "2026-11-12T04:00:00Z"
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为数字 0。 |
|
object |
新排队或已有创建结果。HTTP 为202,不能仅据状态码判断是新请求。 |
|
string |
关联工单 ID。 |
|
string |
bug、feature 或 auto;创建策略,不等同最终 GitHub Type。 |
|
string |
pending、creating、created 或 failed;与工单 status 独立。 |
|
string |
已冻结的请求标题。 |
|
string |
已冻结且规范化的请求正文。 |
|
string |
本次创建尝试标识;重试可产生新值。 |
|
string |
请求创建的管理员主体。 |
|
integer |
对应异步处理尝试次数。 |
|
string / null |
最近尝试时间;未发生时为 null。 |
|
integer / null |
创建回执中的 Issue 编号,未创建时为 null。 |
|
string / null |
创建回执中的 Issue 地址,未创建时为 null。 |
|
string |
创建成功时记录的请求者主体,未完成可为空字符串。 |
|
string / null |
收到创建回执的时间,未完成时为 null。 |
|
string |
安全错误代码;未发生可为空字符串。 |
|
string |
创建时间,RFC 3339。 |
|
string |
更新时间,RFC 3339。 |
嵌套工单、用户、消息、审批事实和 GitHub 请求的全部公开字段见公共对象。字段可空与可省略分别列明,不把旧 SDK fixture 的 submitter_email 当作当前字段。
错误响应¶
{"code":"Unauthorized","msg":"Unauthorized"}
字段 |
类型 |
说明 |
|---|---|---|
|
string / integer |
随失败阶段而异;示例为认证层字符串。 |
|
string |
认证或服务层失败文本,服务层通常本地化。 |
|
string |
参数解析阶段数字错误码的文本;与 msg 区分。 |
|
null |
当前服务层 responseEnvelope 错误保留 null;认证示例可不含此字段。 |
|
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 |
内部处理或本地化失败;写请求错误后先回读确认。 |
409 / ErrFeedbackGitHubIssueInProgress |
请求仍pending/creating,回查原 request_id,不重复提交。 |
409 / ErrFeedbackGitHubIssueRetryRequired |
已失败且未显式 retry。 |
409 / ErrFeedbackGitHubIssueSensitiveContent |
提交内容命中敏感检测,修改后重新人工核对。 |
503 / ErrFeedbackGitHubIssueCreatorUnavailable |
新请求未配置创建工作区。 |
403 / ErrFeedbackGitHubIssueForbidden |
入队准备或执行身份被拒绝。 |
422 / ErrFieldRequired 或 ErrFieldTooLong |
最终标题/正文为空或超长;不是通用草稿400。 |
完整错误族与各阶段见错误和恢复。