エラー

{
  "code": "insufficient_balance",
  "error": "Not enough funds",
  "request_id": "9f3c1e2a7b4d5e60"
}

code で分岐してください。一部のエラーには追加のフィールドがあります:

{
  "code": "invalid_targeting",
  "error": "Unknown city",
  "field": "city",
  "value": "nosuchcity"
}
{
  "code": "unsupported_field",
  "error": "Field is not supported here",
  "field": "count"
}
{
  "code": "rate_limited",
  "error": "Too many requests",
  "retry_after": 12,
  "limit": 120
}

GET /api/v1/orders/{id} の 404 には error と request_id だけが含まれ、code はありません。

コード一覧

コード	ステータス	発生するとき
invalid_api_key	401	キーが受け付けられない
validation_failed	400	フィールドの制約に違反
invalid_body	400	本文またはフィールドの形式が正しくない
unknown_product	400	スラッグが不明、または商品が販売されていない
insufficient_scope	403	ルートが必要とする権限がキーにない
not_found	404	リソースが存在しない、または別のアカウントのもの
idempotency_in_progress	409	このキーでの前のリクエストがまだ実行中
replace_in_progress	409	パッケージのアドレスの交換がすでに進行中
invalid_volume	422	容量が商品の範囲外
invalid_quantity	422	1 回の購入で取得できる数より多いアドレス
country_unavailable	422	この商品ではその国は販売されていない
unknown_plan, unknown_operator, unknown_period	422	選んだ国にそのプラン、ロケーション、期間がない - パラメータ を確認する
out_of_stock	422	ロケーションの空きアドレスが要求数より少ない
unsupported_capability	422	操作がこのパッケージの種類に該当しない
package_expired	422	アドレスのパッケージの期間が終了した - 先に延長する
prolong_window_closed	422	延長でアドレスを戻すことはもうできない - 新規購入が必要
type_unavailable	422	この構成は見積もりも販売もできない
insufficient_balance	422	残高不足
unsupported_field	422	本文に適用できないキーがある。field 付き
invalid_targeting	422	値がジオカタログにない。field と value 付き
package_unavailable	422	パッケージの現在の状態、またはこの設定では操作できない
purchase_refunded	422	購入は成立せず、返金された
idempotency_key_required	422	Idempotency-Key ヘッダーがない
idempotency_key_invalid	422	ヘッダーが空、または 255 文字を超える
idempotency_key_reused	422	同じキーで異なる本文
rate_limited	429	キーの上限に達した
replace_cooldown	429	最近アドレスを交換した。再び可能になる日時は replace_available_at にある
order_failed	500	注文は作成されず、残高は引き落とされていない
package_failed	500	パッケージの操作に失敗し、引き落としはない
order_needs_attention	500	引き落とし済みだが発行されず、手動で調査中
operation_indeterminate	500	結果が確定していない操作のキーでの再試行
catalog_unavailable	503	商品のジオカタログがまだ同期されていない

支払いを伴う操作

コード	お金	対応
order_failed, package_failed	引き落とされていない	同じ Idempotency-Key で再試行する
purchase_refunded (422)	返金済み	新しいキーで新しい購入としてやり直す
order_needs_attention	引き落とし済み、結果を確認中	再試行しない、order_id を添えてサポートへ
operation_indeterminate	結果が確定していない	同じキーで再試行しない。注文とパッケージを確認し、その後サポートへ

5xx のメッセージは中立的な内容です - code で分岐してください。

サポート: @ipvrent_support、 [email protected]。エラー本文の request_id と、あれば order_id を 添えてください。

再試行

タイムアウトはエラーではありません: リクエストは届いている可能性があります。同じ Idempotency-Key で再試行すると同じレスポンスが返ります。409 idempotency_in_progress の 場合は、待ってから同じキーで再試行してください。

再試行しないもの: insufficient_balance、invalid_volume、invalid_quantity、unknown_product、 unsupported_field、unsupported_capability、invalid_targeting、prolong_window_closed。 rate_limited では Retry-After を、replace_cooldown では replace_available_at を待って ください。