# 提交反馈工单

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

提交问题描述及可选的对话记录，获取工单ID和编号，随后通过本人列表跟踪处理状态。此接口创建平台内工单，不创建GitHub Issue。

```text
POST https://api.moi.matrixorigin.cn/v5/feedback-tickets
```

## 调用前准备

`MOI_ENDPOINT` 使用产品 API 前缀 `https://api.moi.matrixorigin.cn/v5`；专有部署填写对应的产品 API 地址。

准备当前环境的个人访问令牌，将MOI_ENDPOINT设置为包含API前缀的地址；工单归属由当前认证主体确定，不接受客户端指定account_id或uc_account_id。运行任务证明不能代替普通认证。

## 请求参数

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

```bash
curl -X POST "$MOI_ENDPOINT/feedback-tickets" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"title":"工作流发布后未找到API服务","description":"发布完成后，API服务列表没有出现对应服务。","expected_behavior":"可以在API服务列表找到新服务。","actual_behavior":"刷新列表后仍未找到。","reproduction_steps":"发布工作流后打开API服务列表。","suggested_priority":"请协助排查","messages":[{"role":"user","content":"发布后没有找到API服务。"}]}'
```

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

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| title | string 或 null | 否 | 问题标题。建议填写，便于识别工单。 |
| description | string 或 null | 否 | 问题说明。 |
| expected_behavior | string 或 null | 否 | 预期结果。 |
| actual_behavior | string 或 null | 否 | 实际结果。 |
| reproduction_steps | string 或 null | 否 | 重现步骤。 |
| suggested_priority | string 或 null | 否 | 建议优先级说明；当前没有固定枚举，不会直接设置管理员处理状态。 |
| messages | object（对象数组） | 否 | 可选对话记录，最多50条；省略、null或空数组均表示没有对话记录。 |
| messages[].role | string | 是 | user或assistant，不接受system或tool。 |
| messages[].content | string | 是 | 内容不能仅含空白，最多8000个Unicode字符；不按UTF-8字节数计数。 |

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

## 成功响应

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

```json
{
  "code": 0,
  "data": {
    "id": "019a1234-1234-7123-8123-123456789abc",
    "ticket_no": "FB-00000001",
    "account_id": "principal-example",
    "uc_account_id": null,
    "title": "工作流发布后未找到API服务",
    "description": "发布完成后，API服务列表没有出现对应服务。",
    "expected_behavior": "可以在API服务列表找到新服务。",
    "actual_behavior": "刷新列表后仍未找到。",
    "reproduction_steps": "发布工作流后打开API服务列表。",
    "suggested_priority": "请协助排查",
    "status": "submitted",
    "admin_reply": null,
    "created_at": "2026-11-12T01:00:00Z",
    "updated_at": "2026-11-12T01:00:00Z",
    "messages": [
      {
        "sequence": 0,
        "role": "user",
        "content": "发布后没有找到API服务。",
        "created_at": "2026-11-12T01:00:00Z"
      }
    ]
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code | integer | 成功为0。此接口不返回成功msg字段。 |
| data | object | [工单对象](ticket-fields.md)。有对话时包含messages；没有对话时省略messages。 |

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

## 错误响应

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

```json
{"code":2,"message":"feedback ticket transcript is invalid"}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code | integer | 处理器错误为数字：2无效请求，5无权限，6未认证，15依赖不可用，1内部错误。认证中间层也可能返回字符串code/msg，需按实际封套解析。 |
| message | string | 当前处理器的错误信息；不能按msg字段读取。 |

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

提交成功后保存id和ticket_no。当前请求没有幂等键，网络超时后直接重试可能生成新工单；可先查看[本人列表](list-my-tickets.md)，再决定是否重新提交。
