レート制限
mixi2 API では、プラットフォームの安定性を維持するため各 API にレート制限が設けられています。
レート制限はアプリケーション単位で適用されます。
API ごとの制限
Section titled “API ごとの制限”| RPC | 制限 | ウィンドウ |
|---|---|---|
CreatePost | 10 回 | 1 分 |
SendChatMessage | 10 回 | 1 分 |
InitiatePostMediaUpload | 10 回 | 1 分 |
InitiatePostMediaUpload | 100 回 | 1 時間 |
AddStampToPost | 10 回 | 1 分 |
GetUsers | 10 回 | 1 分 |
GetPosts | 10 回 | 1 分 |
メディアアップロードのデータ量制限
Section titled “メディアアップロードのデータ量制限”| 項目 | 制限 |
|---|---|
| アップロード容量 | 1 GB / 日 |
レスポンスヘッダー
Section titled “レスポンスヘッダー”すべての API レスポンスに現在のレート制限状況を示すヘッダーが含まれます。
| ヘッダー | 説明 |
|---|---|
ratelimit-limit | リクエスト回数の上限値 |
ratelimit-remaining | 現在のウィンドウ内で残っているリクエスト数 |
ratelimit-reset | 制限がリセットされる時刻（UNIX 秒） |
retry-after | 制限超過時のみ。再試行まで待機すべき秒数 |
制限超過時のレスポンス
Section titled “制限超過時のレスポンス”| 項目 | 値 |
|---|---|
| gRPC ステータスコード | RESOURCE_EXHAUSTED（code 8） |
| エラーメッセージ | rate limit exceeded |
retry-afterヘッダーの値に従って待機する（即時リトライは避ける）retry-afterがない場合はratelimit-resetの時刻まで待機する- ジッター付きの指数バックオフでリトライする