ERRORS
エラー(401・402・403・429)の原因と対処
API が返すエラーの意味と、再試行してよいかの目安です。403 は課金されません。
目次
一覧
| コード | 意味 | 対処 |
|---|---|---|
| 401 | キーが無効、または入れ替えの猶予が切れた | キーを確認する。必要なら再発行 |
| 403 | 契約中のプランで使えない機能 | プランを確認する。課金されません |
| 402 | 当月の件数の上限を超えた | 利用量とプランを確認する |
| 429 | 短時間に多すぎる | Retry-After の秒数だけ待って再試行 |
| 503 | 処理の準備ができていない | 少し待って再試行 |
再試行してよいもの
429 と 503 は、待てば成功することがあります。401・403・402 は、再試行しても同じ結果です。原因を直してください。
判定の順番
401、403、402、429 の順に判定されます。403 は課金されず、402(月間の件数)は 429(秒間の上限)より先に判定されます。
要確認 当月の上限を超えたときの扱い(そのまま止めるか、超過分を課金するか)は、確定待ちです。現時点の API は、402 を返します。
解決しないときは、お問い合わせください。request_id をお知らせいただければ、住所の本文は不要です。