读取管理工单详情

读取一张工单及当前消息、GitHub 请求和奖励审批关联。

GET https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/{id}

调用前准备

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

读取本身不审批、不发布外部 Issue。空 messages 使用 omitempty,可能省略;不能要求始终返回空数组。

请求参数

curl -X GET "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/ticket-example" \
  -H "Authorization: Bearer $GENESIS_ADMIN_TOKEN"

参数

类型

是否必填

说明

Authorization

string

Bearer示例是

Bearer 加当前环境可信管理员令牌;不要同时设置 API Key。

id

string

是

路径工单 ID。

成功响应

{
  "code": 0,
  "data": {
    "id": "ticket-example",
    "ticket_no": "FB-EXAMPLE",
    "account_id": "principal-example",
    "uc_account_id": "uc-example",
    "title": "示例反馈",
    "description": "界面显示结果与预期不同。",
    "expected_behavior": null,
    "actual_behavior": null,
    "reproduction_steps": null,
    "suggested_priority": null,
    "status": "submitted",
    "admin_reply": null,
    "created_at": "2026-11-12T04:00:00Z",
    "updated_at": "2026-11-12T04:00:00Z",
    "user_info": {
      "name": "示例用户",
      "accounts": []
    },
    "messages": [
      {
        "sequence": 0,
        "role": "user",
        "content": "示例反馈内容。",
        "created_at": "2026-11-12T04:00:00Z"
      }
    ]
  }
}

字段

类型

说明

code

integer

成功为数字 0。

data

object

工单数据。

data.id

string

对象 ID。

data.ticket_no

string / null

反馈编号,可为 null。

data.account_id

string

提交工单的产品主体 ID。

data.uc_account_id

string / null

创建时保存的 UC 账号事实,可为 null;不是本次管理员的账号。

data.user_info

object / null,可省略

管理员读取时从当前身份目录投影的提交者信息;可省略,未持久化在工单中。

data.title

string / null

标题;工单可为 null。

data.description

string / null

问题描述,可为 null。

data.expected_behavior

string / null

期望行为,可为 null。

data.actual_behavior

string / null

实际行为,可为 null。

data.reproduction_steps

string / null

复现步骤,可为 null。

data.suggested_priority

string / null

用户建议优先级,可为 null,不承诺已分诊。

data.status

string

工单状态 submitted、processing 或 closed。

data.admin_reply

string / null

管理员回复,可为 null;空字符串与 null 不同。

data.created_at

string

创建时间,RFC 3339。

data.updated_at

string

更新时间,RFC 3339。

data.messages

object(对象数组),可省略

可选对话记录;列表未加载,详情空集合因 omitempty 可省略。

data.github_issue

object / null,可省略

可选主 GitHub Issue 请求;列表、详情与更新均可带该关联。

data.reward_event

object / null,可省略

可选奖励审批事实;列表当前未加载,详情与更新按存在与否返回。

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

错误响应

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

字段

类型

说明

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

内部处理或本地化失败;写请求错误后先回读确认。

完整错误族与各阶段见错误和恢复。

最后更新于