レート制限

パートナー向け API key quotas は計画中ですが、まだ強制されていません。

現在の状態

現在、public API keys に対する partner-facing rate limit policy はありません。rate quotas は #42 の Phase 5 まで延期されています。

partner quotas が実装されると、responses には rate-limit headers が含まれる予定です。

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1780272000

quota により request が拒否された場合、VoiceAgent は 429 Too Many Requests を返します。clients は Retry-After がある場合はその値を読み取り、backoff を使って retry してください。

Retry-After: 30

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests"
  }
}

可能な限り retries が idempotent になるように integrations を設計してください。 429 および一時的な 503 responses には、上限付きの exponential backoff を使用してください。