ドキュメント

TicketsX をもっと早く使いこなす

セットアップ手順、コマンドの完全リファレンス、Premium 機能、REST API がひとつにまとまっています。

13.2

チケットの一覧取得

GET/<guild_id>/api/tickets

サーバーの未クローズのチケット一覧を取得します。担当状況、ユーザー、作成者による絞り込みも指定できます。

クエリパラメーター

名前必須説明
filterstring
任意
状態でチケットを絞り込みます。指定できる値: claimedmine
user_idstring
任意
このユーザーが参加しているチケットに絞り込みます。
creator_idstring
任意
このユーザー ID が作成したチケットに絞り込みます。
limitnumber
任意
1 ページあたりの件数、1-100(既定値 50)。
offsetnumber
任意
ページ送りで読み飛ばす件数(既定値 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"