すべてのプロダクト
Search
ドキュメントセンター

API Gateway:エラーコード表におけるエラーのトラブルシューティング

最終更新日:Jun 18, 2026

API unsupport the channel

原因

リクエスト内の HTTP スキーマが無効です。

各 API は異なる HTTP スキーマをサポートしています。API プロバイダーは、API を設定して HTTP リクエストのみ、HTTPS リクエストのみ、または両方を許可できます。

API unsupport the channel:HTTPS のみをサポートする API に対して HTTP リクエストが送信されました。

API unsupport the channel:HTTP のみをサポートする API に対して HTTPS リクエストが送信されました。

ソリューション

API unsupport the channel:API を呼び出す際に HTTP の代わりに HTTPS を使用してください。

API unsupport the channel:API を呼び出す際に HTTPS の代わりに HTTP を使用してください。

A403IS

原因

クライアント側で提供された署名が、サーバー側の署名と一致しません。

ソリューション

署名が一致しない場合、API Gateway は、サーバー側の署名を計算するために使用された StringToSign パラメーターを X-Ca-Error-Message レスポンスヘッダーに返します。

StringToSign には、リクエスト送信前に署名計算に使用される文字列が含まれます。詳細については、「ダイジェスト認証を使用した API 呼び出し」をご参照ください。

ローカルの StringToSign を取得し、レスポンスで返された StringToSign と比較してください。公式デモを使用している場合は、署名計算ツールクラスを通じて StringToSign を取得できます。

HTTP レスポンスヘッダー内では改行が許可されないため、レスポンス内の StringToSign から改行が削除されています。ドキュメントを参照し、適切に文字列を比較してください。

クライアント側とサーバー側の文字列が一致する場合は、AppKey と AppSecret が有効であることを確認してください。たとえば、余分なスペースが含まれていないかをチェックします。

Invalid Url

原因

リクエスト内の HTTP メソッド、パス、または環境 (X-Ca-Stage) が無効です。

たとえば、テスト環境にある API を対象としたリクエストを送信したものの、その API が当該環境に公開されていない場合などです。

注意:

  • リクエストで環境を指定しない場合、デフォルトで本番環境 (RELEASE) にリクエストが送信されます。

  • API 定義を変更した場合は、変更内容を反映させるために API を再度公開する必要があります。このエラーは、API パスを変更したにもかかわらず API を再公開していない場合に発生することがよくあります。

ソリューション

リクエスト内の以下の 3 つの要素を確認してください:HTTP メソッド、パス、および環境。

  1. リクエストで指定する HTTP メソッドを、API 定義と同一にしてください。たとえば、POST メソッドで呼び出す必要のある API に対して、リクエストで GET を指定しないでください。

  2. リクエストで指定するパスを、実際に利用中のパスに基づいて設定してください。API を所有している場合は、変更後に必ず再公開することを忘れないでください。

  3. API を呼び出したい環境を明示的に指定してください。リクエスト内で X-Ca-Stage ヘッダーを使用します。有効な値は TEST、PRE、および RELEASE で、それぞれテスト環境、ステージング環境、および本番環境を示します。このヘッダーを指定しない場合、リクエストはデフォルトで本番環境に送信されます。

Unauthorized

原因

アプリケーションが API を呼び出す権限を付与されていません。

ソリューション

以下のソリューションをお試しください。

  1. API を作成した場合は、API Gateway コンソールでアプリケーションを作成し、その API を呼び出す権限を付与してください。テスト目的で自分自身が所有する API を呼び出す場合でも、アプリケーションの作成は必須です。

  2. API を購入した場合は、アプリケーション詳細ページで、そのアプリケーションが呼び出せる API を確認してください。対象の API が一覧に表示されていない場合は、アプリケーションに対する権限付与を取得してください。

  3. API がパートナーに属している場合は、パートナーに連絡して権限付与を依頼してください。パートナーがアプリケーションを権限付与できるよう、ご利用のアプリケーション ID (AppId) を提供してください。

  4. 権限付与は環境ごとに個別に行われます。ある環境で権限付与されたアプリケーションは、別の環境で同じ API を呼び出すことはできません。

  5. 正しいアプリケーションを使用し、正しい API を呼び出していることを確認してください。複数のアプリケーションや API が存在する場合、誤って不一致が生じることがよくあります。