提交与查询反馈工单

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

前提条件

按调用前准备准备当前环境的个人访问令牌和服务地址。工单归属由当前认证主体决定,调用时不需要工作区 ID,也不支持指定其他账号查询。

调用顺序

  1. 收集问题描述、预期结果、实际结果、复现步骤或可选对话消息,调用提交反馈工单。

  2. 保存响应返回的任务 ID 和工单编号;如请求超时但不确定是否已创建,先查询本人列表避免重复提交。

  3. 随后分页调用查询本人反馈工单,跟踪处理状态和管理员回复。

API 操作

要完成的事

API 操作

何时使用或确认什么

创建平台内反馈工单

提交反馈工单

需要提交问题描述并获取工单 ID 和工单编号时使用。

查询当前账号提交的工单

查询本人反馈工单

需要跟进处理状态和管理员回复,或超时重试前确认是否已生成工单时使用。

结果确认

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

限制和注意事项

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

最后更新于