レート制限・ページネーション
APIのレート制限とページネーションの仕様です。
レート制限
| プラン | リクエスト上限 | ウィンドウ |
|---|---|---|
| Free | 60リクエスト | 1分間 |
| Pro | 300リクエスト | 1分間 |
| Studio | 1000リクエスト | 1分間 |
レート制限ヘッダー
すべてのAPIレスポンスに以下のヘッダーが含まれます。
| ヘッダー | 説明 |
|---|---|
X-RateLimit-Limit | ウィンドウ内の最大リクエスト数 |
X-RateLimit-Remaining | ウィンドウ内の残りリクエスト数 |
Retry-After | 429応答時、リトライまでの秒数 |
ページネーション
リスト系のAPIエンドポイントはカーソルベースのページネーションを使用します。
// リクエスト
GET /api/v1/projects?limit=20&cursor=prj_abc123
// レスポンス
{
"data": [...],
"pagination": {
"cursor": "prj_def456",
"has_more": true
}
}次のページを取得するには、レスポンスの pagination.cursor を 次のリクエストの cursor パラメータに指定します。has_more が false になるまで繰り返してください。