13.2
チケットの一覧取得
GET
/<guild_id>/api/ticketsサーバーの未クローズのチケット一覧を取得します。担当状況、ユーザー、作成者による絞り込みも指定できます。
クエリパラメーター
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| filter | string | 任意 | 状態でチケットを絞り込みます。指定できる値: claimed、mine。 |
| user_id | string | 任意 | このユーザーが参加しているチケットに絞り込みます。 |
| creator_id | string | 任意 | このユーザー ID が作成したチケットに絞り込みます。 |
| limit | number | 任意 | 1 ページあたりの件数、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"