ドキュメントAPI リファレンスレート制限・ページネーション

レート制限・ページネーション

APIのレート制限とページネーションの仕様です。

レート制限

プランリクエスト上限ウィンドウ
Free60リクエスト1分間
Pro300リクエスト1分間
Studio1000リクエスト1分間

レート制限ヘッダー

すべてのAPIレスポンスに以下のヘッダーが含まれます。

ヘッダー説明
X-RateLimit-Limitウィンドウ内の最大リクエスト数
X-RateLimit-Remainingウィンドウ内の残りリクエスト数
Retry-After429応答時、リトライまでの秒数

ページネーション

リスト系のAPIエンドポイントはカーソルベースのページネーションを使用します。

// リクエスト
GET /api/v1/projects?limit=20&cursor=prj_abc123

// レスポンス
{
  "data": [...],
  "pagination": {
    "cursor": "prj_def456",
    "has_more": true
  }
}

次のページを取得するには、レスポンスの pagination.cursor を 次のリクエストの cursor パラメータに指定します。has_morefalse になるまで繰り返してください。