# 提交与查询反馈工单

提交平台内问题反馈或产品咨询工单，并查询当前认证主体已提交工单的处理状态与管理员回复。创建接口返回工单详情和本次对话；本人列表接口只返回工单摘要。

## 前提条件

按[调用前准备](../../api-call-basics.md)准备当前环境的个人访问令牌和服务地址。工单归属由当前认证主体决定，调用时不需要工作区 ID，也不支持指定其他账号查询。

## 调用顺序

1. 收集问题描述、预期结果、实际结果、复现步骤或可选对话消息，调用[提交反馈工单](../../../../reference/api/genesis/feedback-tickets/create-ticket.md)。
2. 保存响应返回的任务 ID 和工单编号；如请求超时但不确定是否已创建，先查询本人列表避免重复提交。
3. 随后分页调用[查询本人反馈工单](../../../../reference/api/genesis/feedback-tickets/list-my-tickets.md)，跟踪处理状态和管理员回复。

## API 操作

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 创建平台内反馈工单 | [提交反馈工单](../../../../reference/api/genesis/feedback-tickets/create-ticket.md) | 需要提交问题描述并获取工单 ID 和工单编号时使用。 |
| 查询当前账号提交的工单 | [查询本人反馈工单](../../../../reference/api/genesis/feedback-tickets/list-my-tickets.md) | 需要跟进处理状态和管理员回复，或超时重试前确认是否已生成工单时使用。 |

## 结果确认

创建成功后检查返回工单中的编号与初始状态；查询本人列表时使用 `limit` 和 `offset` 翻页，直到已读数量达到 `total` 或当前页返回空列表。

## 限制和注意事项

普通用户仅支持按本人主体分页查询摘要，不支持管理员跨账号筛选条件，也没有按单个工单 ID 读取完整对话的普通用户接口。
