🍀

【Shopify.dev和訳】API usage/Response status codes

2021/09/09に公開約10,500字

この記事について

この記事は、API usage/Response status codesの記事を和訳したものです。

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Shopify API レスポンスステータスとエラーコード

Shopify が API エンドポイントへのリクエストを受信すると、元のリクエストに応じて、いくつかの異なる HTTP ステータスコードがレスポンスで返されます。

ステータスコード 意味
200 OK リクエストは Shopify によって正常に処理されました。
201 Created リクエストは達成され、新しいリソースが作成されました。
202 Accepted リクエストは受理されましたが、まだ処理されていません。
303 See Other リクエストに対するレスポンスは Location ヘッダーの別の URL にあり、そのリソースに対して GET メソッドを使って取得できます。
400 Bad Request リクエストがサーバーに理解されませんでした。一般的には、構文が間違っているか、Content-Type ヘッダーが正しく application/json に設定されていないことが原因です。 このステータスは、OAuth トークンの交換プロセスにおいて、リクエストが無効なcodeパラメータを提供した場合にも返されます。
401 Unauthorized 必要な認証情報がリクエストに含まれていないか、間違っています。
402 Payment Required リクエストされたショップは現在凍結されています。凍結を解除するには、ショップオーナーがショップの管理画面にログインし、未払い金を支払う必要があります。
403 Forbidden サーバーがリクエストへの応答を拒否しています。これは一般的に、このアクションに対して適切なスコープを要求していないためです。
404 Not Found 要求されたリソースは見つかりませんでしたが、将来的に再び利用可能になる可能性があります。
406 Not Acceptable 要求されたリソースは、リクエストで送信された Accept ヘッダによれば、受け入れられないコンテンツを生成することしかできません。
422 Unprocessable Entity リクエストボディは正しく形成されていますが、セマンティックエラーが含まれています。422 のエラーコードは、以下のような様々な状況で返される可能性がありますが、これらに限定されるものではありません。
・誤ってフォーマットされた入力
・在庫切れの商品をチェックアウトする
・フルフィルメントのある注文のキャンセル
・ラインアイテムとオーダーの両方にタックスラインがあるオーダーの作成
・電子メールや名前のない顧客の作成
・タイトルのない商品の作成
レスポンスボディには、errorserrorパラメーターの詳細が記載されています。
423 Locked 要求されたショップは現在ロックされています。ショップがロックされるのは、API リクエストの制限を繰り返し超えた場合や、アカウントの侵害や詐欺のリスクが検出されるなど、アカウントに問題がある場合です。ショップがロックされている場合は、サポートにお問い合わせください。
429 Too Many Requests アプリケーションがレート制限を超えたため、リクエストが受け入れられませんでした。Shopify の API レートリミットについてはこちらをご覧ください。
500 Internal Server Error Shopify で内部エラーが発生しました。Shopify のスタッフが調査できるように、Shopify APIs and SDKs フォーラムに投稿してください。
501 Not Implemented 要求されたエンドポイントはそのショップでは利用できません。例えば、Shopify Plus 専用の API へのアクセスを非 Plus のショップに要求した場合などです。このレスポンスは、このエンドポイントが将来の使用のために予約されていることを示す場合もあります。
503 Service Unavailable サーバーは現在利用できません。Shopify のステータスページでサービス停止の報告を確認してください。
504 Gateway Timeout リクエストは時間内に完了できませんでした。Shopify は応答を最大 10 秒間待ちます。複数の小さなリクエストに分けてみてください。

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Discussion

ログインするとコメントできます