查询访客工单列表

按访客 uid 查询该访客的工单简要列表，按创建时间倒序返回。limit 缺失、越界或小于等于 0 时使用默认值 100；offset 缺失或不在 1..当前总数范围内时使用 0。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
uid	string	是	访客外部 ID（uid）	user_3f9a2c8d
limit	int64	否	每页数量，默认 100，最大 100；小于等于 0 或大于 100 时使用默认值	50
offset	int64	否	偏移量，默认 0；只有大于 0 且不超过当前访客工单总数时生效	0

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	object[]	工单简要列表，每项含 id/title/status/createtime	[{"id":123456,"title":"售后咨询：订单取消后未退款","status":10,"createtime":"2024-07-04 10:30:00"}]
└id	int64	工单 ID	123456
└title	string	工单标题	售后咨询：订单取消后未退款
└status	int32	工单状态：0-未知，1-已提交，5-未受理，10-受理中，20-完结，25-已驳回，50-已挂起，999-已删除	10
└createtime	string	创建时间（可读格式）	2024-07-04 10:30:00

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	time 缺失，或请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON；或 uid 缺失
14105	uid 对应访客不存在
14500	服务内部异常；请求字段类型不符合要求或服务处理失败
16001	企业工单服务不可用

postEndpoint

/openapi/worksheet/list

curl -X POST "https://qiyukf.com/openapi/worksheet/list?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \  -H "Content-Type: application/json" \  -d '{    "uid": "user_3f9a2c8d"  }'

{
  "code": 200,
  "message": [
    {
      "id": 123456,
      "title": "售后咨询：订单取消后未退款",
      "status": 10,
      "createtime": "2024-07-04 10:30:00"
    }
  ]
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "time 缺失，或请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体不是合法 JSON；或 uid 缺失"
}

{
  "code": 14105,
  "message": "uid 对应访客不存在"
}

{
  "code": 14500,
  "message": "服务内部异常；请求字段类型不符合要求或服务处理失败"
}

{
  "code": 16001,
  "message": "企业工单服务不可用"
}