审批工单奖励¶
记录不含金额的奖励审批事实,可同时更新工单状态和回复。
POST https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/{id}/reward-approval
调用前准备¶
准备当前环境可用的 Genesis 管理员 Bearer;普通个人访问令牌、X-API-Key 和工作区 Owner 不能替代。会话模式的写操作另需 CSRF。参见AI Studio。示例 ID 需换为获准查看的真实工单 ID。
{} 是有效审批请求,工单必须有非空 UC 账号事实。成功不是已到账,不接收 amount、credit 或 reward_policy;下游活动规则与发放由消费方负责。重复审批复用首次事件,但携带的状态/回复仍可能更新。审批提交后还会独立读取详情,回读失败可在审批已持久化后报错;先回读,不盲目重发。
请求参数¶
curl -X POST "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/ticket-example/reward-approval" \
-H "Authorization: Bearer $GENESIS_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
--data '{}'
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
Bearer示例是 |
Bearer 加当前环境可信管理员令牌;不要同时设置 API Key。 |
|
string |
是 |
路径工单 ID。 |
|
string |
否 |
processing 或 closed;省略/null 不改状态。 |
|
string / null |
否 |
省略/null 不改回复;空字符串可显式清空。 |
成功响应¶
{
"code": "OK",
"msg": "OK",
"data": {
"ticket": {
"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"
}
],
"reward_event": {
"id": "event-example",
"event_type": "feedback.reward_approved",
"source_type": "feedback_ticket",
"source_id": "ticket-example",
"subject_uc_account_id": "uc-example",
"approved_by": "admin-example",
"occurred_at": "2026-11-12T04:00:00Z",
"delivery_status": "pending",
"attempt_count": 0,
"last_attempt_at": null,
"last_error": null,
"billing_transaction_id": null,
"granted_at": null,
"created_at": "2026-11-12T04:00:00Z",
"updated_at": "2026-11-12T04:00:00Z"
}
},
"reward_event": {
"id": "event-example",
"event_type": "feedback.reward_approved",
"source_type": "feedback_ticket",
"source_id": "ticket-example",
"subject_uc_account_id": "uc-example",
"approved_by": "admin-example",
"occurred_at": "2026-11-12T04:00:00Z",
"delivery_status": "pending",
"attempt_count": 0,
"last_attempt_at": null,
"last_error": null,
"billing_transaction_id": null,
"granted_at": null,
"created_at": "2026-11-12T04:00:00Z",
"updated_at": "2026-11-12T04:00:00Z"
}
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
审批成功为 OK。 |
|
string |
审批成功为 OK。 |
|
object |
审批结果。 |
|
object |
审批后重新读取的工单。 |
|
object |
当前工单唯一的奖励审批事实;不包含金额或活动规则。 |
|
string |
对象 ID。 |
|
string / null |
反馈编号,可为 null。 |
|
string |
提交工单的产品主体 ID。 |
|
string / null |
创建时保存的 UC 账号事实,可为 null;不是本次管理员的账号。 |
|
object / null,可省略 |
管理员读取时从当前身份目录投影的提交者信息;可省略,未持久化在工单中。 |
|
string / null |
标题;工单可为 null。 |
|
string / null |
问题描述,可为 null。 |
|
string / null |
期望行为,可为 null。 |
|
string / null |
实际行为,可为 null。 |
|
string / null |
复现步骤,可为 null。 |
|
string / null |
用户建议优先级,可为 null,不承诺已分诊。 |
|
string |
工单状态 submitted、processing 或 closed。 |
|
string / null |
管理员回复,可为 null;空字符串与 null 不同。 |
|
string |
创建时间,RFC 3339。 |
|
string |
更新时间,RFC 3339。 |
|
object(对象数组),可省略 |
可选对话记录;列表未加载,详情空集合因 omitempty 可省略。 |
|
object / null,可省略 |
可选主 GitHub Issue 请求;列表、详情与更新均可带该关联。 |
|
object / null,可省略 |
可选奖励审批事实;列表当前未加载,详情与更新按存在与否返回。 |
|
string |
对象 ID。 |
|
string |
审批事件类型 feedback.reward_approved。 |
|
string |
来源类型 feedback_ticket。 |
|
string |
关联的工单 ID。 |
|
string |
被审批的提交者 UC 账号。 |
|
string |
首次审批的管理员主体 ID。 |
|
string |
首次审批发生时间,RFC 3339。 |
|
string |
pending 或 granted;审批成功不等于已发放。 |
|
integer |
对应异步处理尝试次数。 |
|
string / null |
最近尝试时间;未发生时为 null。 |
|
string / null |
最近错误文本,可为 null。 |
|
string / null |
消费方账务关联 ID,可为 null。 |
|
string / null |
发放时间,可为 null。 |
|
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 |
内部处理或本地化失败;写请求错误后先回读确认。 |
400 / ErrFeedbackRewardSubjectMissing |
工单未保存可用 UC 账号事实;不能在本请求中伪造补入。 |
400 / ErrFeedbackTicketStatusInvalid 或 ErrParamInvalid |
状态无效或请求解码失败。 |
完整错误族与各阶段见错误和恢复。