共通ルール
ページネーションとフィルター
リソースの特性に応じてオフセット方式とカーソル方式を使用します。
オフセットページネーション
ワークスペース、チーム、メンバー、招待、ロール、エクスポート履歴はoffsetとlimitを使用し、page.totalで総数を確認します。
- 最初のページは
offset=0です。 - 次のページは前の
offset + limitでリクエストします。 - 項目が変更されるとページ間で重複や欠落が生じる場合があります。
レコードカーソル
レスポンスのnext_tokenをそのまま次のレコードまたは共有レコードリクエストに渡します。nullの場合は最終ページです。
フィルターの使用
- 日付はISO 8601形式で送信します。
- 配列クエリパラメータは同じキーを繰り返して送信します。例:
team_ids=7&team_ids=8 GET /labelsで取得したIDをレコードのlabel_idsフィルターに使用します。