MiiTel API （β版）の制限と注意事項

レート制限

ユーザーごとに 1 分あたり 240 リクエスト です。使用しているアクセストークンの MiiTel ユーザー単位で数え、すべてのエンドポイントに適用されます。
上限を超えると 429 が返ります。Retry-After ヘッダーの時間だけ待ってから再試行してください。
レスポンスには RateLimit-Limit、RateLimit-Remaining、RateLimit-Reset が含まれます。RateLimit-Remaining を確認し、上限に達する前にリクエストの頻度を下げてください。

より高い上限が必要な場合は、弊社担当者までご相談ください。

一部のエンドポイントは、呼び出しのたびに大きな処理が発生します。必要以上に呼び出さない設計にしてください。

エンドポイント	避けていただきたい使い方
通話レッグの音声の取得	すべての通話の音声をループで一括ダウンロードすること。必要な通話の音声のみ取得してください。
会議の録画の要約の作成	同じ録画に対して要約の生成を繰り返すこと。作成済みの要約を再利用してください。
音声・録画のアップロード	同じファイルを複数回アップロードすること。

エラーレスポンスはすべて {"code": "public_api.<reason>", "message": "..."} の形式です。エラー処理では message ではなく code で判定してください。

ステータス	対応
`400`, `413`, `422`	リクエストを修正してから再試行してください。
`401`	アクセストークンを再取得してください。
`403`	ユーザーの権限、ご契約、IP アドレス制限をご確認ください。
`404`	ID とテナントをご確認ください。
`429`	`Retry-After` の時間だけ待ってから再試行してください。
`502`, `503`, `504`	参照系のリクエストは指数バックオフで再試行してください。書き込み系は自動で再試行しないでください。

5xx エラーが続く場合は、リクエスト日時（タイムゾーンを含む）、メソッドとパス、テナントコード、ステータス、エラーの code を添えてサポートまでお問い合わせください。トークンやパスワードは絶対に含めないでください。