一般的な API 呼び出しエラーのトラブルシューティング - API Gateway

API unsupport the channel

原因

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

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

API unsupport the channel：このエラーは、HTTPS のみをサポートする API に対して HTTP リクエストが送信された場合に発生します。

API unsupport the channel：このエラーは、HTTP のみをサポートする API に対して HTTPS リクエストが送信された場合に発生します。

解決策

API unsupport the channel：HTTPS を要求する API の場合は、HTTP ではなく HTTPS を使用して API を呼び出してください。

API unsupport the channel：HTTP を要求する API の場合は、HTTPS ではなく HTTP を使用して API を呼び出してください。

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 メソッド、パス、環境。

API 定義と同じ HTTP メソッドを使用してください。たとえば、API が POST を必要とする場合、GET リクエストを送信しないでください。
正しいリクエストパスを使用してください。API を所有している場合は、変更後に再公開してください。
API を呼び出す環境を指定してください。リクエストでは X-Ca-Stage ヘッダーを使用します。有効な値：TEST、PRE、RELEASE。これらはそれぞれテスト環境、ステージング環境、本番環境を示します。ヘッダーを指定しない場合、リクエストはデフォルトで本番環境に送信されます。

Unauthorized

原因

アプリケーションは、API を呼び出すように承認されていません。

解決策

次の解決策を試してください：

API を作成した場合は、API Gateway コンソールでアプリケーションを作成し、API を呼び出すように承認してください。自分の API をテストする場合でも、アプリケーションは必要です。
API を購入した場合は、アプリケーションの詳細ページで承認済みの API のリストを確認してください。対象の API がリストにない場合は、承認をリクエストしてください。
API がパートナーのものである場合は、パートナーに連絡して承認を依頼してください。パートナーがアプリケーションを承認できるように、アプリケーション ID (AppId) を提供してください。
承認は環境固有です。1 つの環境で承認済みのアプリケーションは、別の環境で同じ API を呼び出すことはできません。
正しいアプリケーションと API の組み合わせを使用していることを確認してください。複数のアプリケーションまたは API がある場合、不一致がよく発生します。

I403AA

原因

呼び出し元のアプリケーションが対象 API を呼び出すために必要なアクセス権限を持っていないため、承認チェックが失敗します。

API Gateway は HTTP ステータスコード 403 を返します。X-Ca-Error-Code レスポンスヘッダーは I403AA で、X-Ca-Error-Message レスポンスヘッダーは Invalid App Authorization no permission です。

解決策

API Gateway コンソールで、呼び出し元のアプリケーションが対象 API を呼び出すために必要なアクセス権限を持っているかどうかを確認してください。承認がない場合は、コンソールで呼び出し元のアプリケーションを承認するか、SetApisAuthorities を呼び出して必要なアクセス権限を付与してください。その後、リクエストを再送信してください。