エラーコード一覧

すべてのエラー応答は共通の形です。HTTP ステータスだけでなく code を見て分岐してください。

{ "error": { "code": "invalid_request", "message": "..." } }

まずここだけ

• 503 … 時間をおいて再試行。機能が未開放のときもこれです（権限付与が済むまでの間など）
• 429 … Retry-After に従って再試行
• 422 / 400 … リクエストが誤り。そのまま再試行しても変わりません
• 401 / 403 … トークンか scope の問題
• 404 … 対象が無い。権限が無い場合も同じ応答です（存在を漏らさないため）

このページは API の実装から自動生成しています（92 件）。実装と食い違うことはありません。

共通

コード	HTTP	どうすればよいか
internal_error	500	**こちらの問題です。**再現する場合はご連絡ください

認証・トークン

コード	HTTP	どうすればよいか
invalid_client	400 / 401	**リクエストを直してください。**そのまま再試行しても同じ結果になります
invalid_grant	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります
invalid_request	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります
invalid_scope	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります
unsupported_response_type	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります

冪等・レート制限

コード	HTTP	どうすればよいか
idempotency_key_conflict	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
idempotency_key_required	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります
idempotency_request_in_progress	409	**競合しています。**現在の状態を取得し直してください
insufficient_scope	403	**権限が足りません。**必要な scope を確認してください
invalid_token	401	トークンを取り直してください
rate_limited	429	Retry-After に従って再試行してください
service_unavailable	503	時間をおいて再試行してください。機能が未開放の場合もこれを返します
token_revoked	401	トークンを取り直してください
unauthorized	401	トークンを取り直してください

商品・カテゴリー・在庫

コード	HTTP	どうすればよいか
annotation_write_failed	500	**こちらの問題です。**再現する場合はご連絡ください
axis_without_values	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
bundle_not_allowed	400 / 422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
bundle_required	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
cancel_by_after_event_start	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
cancel_by_before_sell_from	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
cancel_by_required	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
category_depth_exceeded	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
category_not_found	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
component_has_variants	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
component_not_found	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
conflict_manual_override	409	**競合しています。**現在の状態を取得し直してください
duplicate_axis	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
duplicate_axis_value	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
duplicate_image_id	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
duplicate_variant_combination	409 / 422	**競合しています。**現在の状態を取得し直してください
duplicate_variant_sku	409 / 422	**競合しています。**現在の状態を取得し直してください
external_ref_conflict	409	**競合しています。**現在の状態を取得し直してください
free_ticket_price_must_be_zero	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
gift_must_not_ship	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
hierarchy_move_not_allowed	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります
image_fetch_failed	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
image_invalid	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
image_not_found	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
image_too_large	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
image_url_not_allowed	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
immutable_field	409	**競合しています。**現在の状態を取得し直してください
immutable_variation_axes	400 / 409	**競合しています。**現在の状態を取得し直してください
incomplete_image_order	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
invalid_parameter	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります
invalid_sell_period	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
invalid_ticket_valid_period	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
inventory_not_updatable_here	400	**リクエストを直してください。**そのまま再試行しても同じ結果になります
inventory_out_of_range	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
lottery_date_before_sell_by	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
lottery_not_allowed	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
lottery_required	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
managed_by_other	409	**競合しています。**現在の状態を取得し直してください
negative_inventory	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
no_image_cannot_activate	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
no_variation_axes	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
number_of_sets_out_of_range	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
number_of_sets_required	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
parent_category_not_found	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
plan_limit_exceeded	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
price_below_minimum	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
readback_failed	500	書き込みは完了しています。再試行しないでください。 GET で現在の状態を取得してください
set_inventory_must_be_null	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
set_inventory_not_updatable	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
set_nesting_forbidden	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
sku_conflict	409	**競合しています。**現在の状態を取得し直してください
status_locked	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
ticket_info_required	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
ticket_not_allowed	400 / 422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
too_many_axes	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
too_many_axis_values	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
too_many_variants	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
unlimited_inventory	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
unsupported_kind	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variant_axis_mismatch	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variant_axis_missing	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variant_axis_value_unknown	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variant_id_required	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variant_item_inventory_must_be_null	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variant_not_found	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variation_incomplete	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
variation_not_allowed	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります

予約・出荷・流入経路

コード	HTTP	どうすればよいか
feature_not_enabled	403	**権限が足りません。**必要な scope を確認してください
invalid_period	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります
invalid_reservation_state	409	**競合しています。**現在の状態を取得し直してください
invalid_transition	409	**競合しています。**現在の状態を取得し直してください
sold_out	409	**競合しています。**現在の状態を取得し直してください
variant_reservation_not_supported	422	**リクエストを直してください。**そのまま再試行しても同じ結果になります