13.2
列出工单
GET
/<guild_id>/api/tickets获取服务器中未关闭的工单列表。支持用可选的查询条件按认领状态、用户或开单者筛选。
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| filter | string | 可选 | 按状态筛选工单。可用值：claimed、mine。 |
| user_id | string | 可选 | 筛选出该用户参与的工单。 |
| creator_id | string | 可选 | 筛选出由该用户 ID 创建的工单。 |
| limit | number | 可选 | 每页数量，1-100（默认 50）。 |
| offset | number | 可选 | 分页时跳过的结果数量（默认 0）。 |
响应中包含一个 pagination 对象：{ total, limit, offset, returned }。只会返回未关闭的工单。
请求示例
curl -X GET \
-H "Authorization: Bearer <API_TOKEN>" \
"https://api.ticketsx.xyz/<guild_id>/api/tickets?filter=claimed&creator_id=123456789"