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"