Amazon旧PA-APIのエラーを、現在のCreators APIと混同せず読むための一覧です。子ページから個別エラーを選択してください。 コード例は保守資料として残し、現在の導入・利用再開を保証する手順とは分けます。
最初に確認する順序
- PA-API 5廃止案内を確認し、呼出先が旧APIか現在のCreators APIかを特定する。
- 接続/タイムアウト、HTTP状態、本文内コードを分ける。401/403をレート超過として繰り返し送信しない。
- 現在の認証は公式移行ガイドに従い、旧AWSキーから専用資格情報とOAuthへ切り替える。
- 現行のエラー資料と対象操作を照合する。AuthorizationやSecret、生の応答を公開質問へ貼らない。
個別エラーの子ページ
- Operation is missing(旧要求の操作指定)
- MissingParameter: Signature(署名項目不足)
- RequestThrottled(要求頻度)
- SignatureDoesNotMatch(署名の不一致)
- HTTP 503 Service Unavailable
各子ページの旧例は、そのAPI世代の資料として参照します。個別記事もすべて現行Creators APIへ更新済み、という意味ではありません。親の関連資料から要求や応答の説明へも進めます。
| この記事の要点 |
|
Amazon PA-API(Product Advertising API)とは
PA-APIはAmazonの商品情報を取得するために使われていた従来APIです。4.0のItemSearchと5.0のSearchItemsを区別し、5.0も廃止案内の対象であることを確認します。旧資料のカート操作などを現行の商品APIで利用できる機能とは扱いません。
主要エラー一覧
以下は旧PA-APIの資料として残す表です。現行Creators APIの完全なエラー一覧ではありません。同じHTTP状態でも原因は複数あり、返された正式なコード・対象操作・API世代と照合します。
| エラーコード | 意味 | 主な原因 |
|---|---|---|
InvalidParameterValue | パラメータ値不正 | ASIN / 国コード / 通貨 |
MissingParameter | 必須パラメータ欠落 | PartnerTag 等の未指定 |
InvalidSignature | 署名不一致 | SigV4 計算ミス、時刻ずれ |
AccessDeniedException | アクセス権限なし | 旧API廃止・対象APIの利用資格等を確認 |
RequestThrottled | スロットリング | TPS 超過 |
TooManyRequests | レート制限 | 1 日のリクエスト上限 |
ItemNotAccessible | 商品アクセス不可 | 地域限定 / 廃番 |
InvalidAssociate | アソシエイト ID 無効 | PartnerTag のスペルミス |
NoResults | 結果ゼロ | 検索キーワード合致なし |
InvalidPartnerTag | PartnerTag 不正 | 登録外のタグ使用 |
エラー1: InvalidParameterValue
要求値が対象APIの期待形式に合わない場合を確認します。頻度順位は測定していません。次は旧形式の例です:
{
"Errors": [{
"Code": "InvalidParameterValue",
"Message": "The ItemId provided in the request is invalid."
}]
}
確認ポイント:
- ASIN: 10 桁の半角英数字(例:
B08N5WRWNW)、ハイフン不可 - Marketplace:
www.amazon.co.jp/www.amazon.com等、URL 形式 - Resources:
ItemInfo.Title等、ドット区切りで正確に - Condition:
New/Used/Collectible/Refurbished(大文字小文字)
エラー2: InvalidSignature
旧SigV4要求では、署名計算と実際の送信内容の不一致等を確認します。下のコードは未実行の旧断片です。 payload/secret_keyの準備・HTTP送信等を含まず、「正しい流れ」「PA-API固定」という元コメントは動作保証ではありません。us-west-2を全地域へ固定せず、日時は同一時点から取得します。Creators APIはOAuth方式のため、この関数の修正だけで移行しません:
// 署名計算の正しい流れ(PHP の例)
$method = "POST";
$service = "ProductAdvertisingAPI";
$region = "us-west-2"; // ★ PA-API 固定
$host = "webservices.amazon.co.jp";
$endpoint = "https://" . $host . "/paapi5/searchitems";
$amz_date = gmdate('Ymd\THis\Z');
$date_stamp = gmdate('Ymd');
// Canonical Request
$canonical_uri = "/paapi5/searchitems";
$canonical_querystring = "";
$canonical_headers = "host:" . $host . "\n" .
"x-amz-date:" . $amz_date . "\n" .
"x-amz-target:com.amazon.paapi5.v1.ProductAdvertisingAPIv1.SearchItems\n";
$signed_headers = "host;x-amz-date;x-amz-target";
$payload_hash = hash('sha256', $payload);
$canonical_request = $method . "\n" . $canonical_uri . "\n" .
$canonical_querystring . "\n" . $canonical_headers . "\n" .
$signed_headers . "\n" . $payload_hash;
// String to Sign
$algorithm = "AWS4-HMAC-SHA256";
$credential_scope = $date_stamp . "/" . $region . "/" . $service . "/aws4_request";
$string_to_sign = $algorithm . "\n" . $amz_date . "\n" . $credential_scope . "\n" .
hash('sha256', $canonical_request);
// Signature
$signing_key = hash_hmac('sha256', $date_stamp, "AWS4" . $secret_key, true);
$signing_key = hash_hmac('sha256', $region, $signing_key, true);
$signing_key = hash_hmac('sha256', $service, $signing_key, true);
$signing_key = hash_hmac('sha256', 'aws4_request', $signing_key, true);
$signature = hash_hmac('sha256', $string_to_sign, $signing_key);
失敗するケース:
- 要求時刻と有効期限を確認する。許容ずれを全API共通の±15分と断定しない
- SecretKey の改行・空白混入
- 署名時と送信時の本文バイト列の違い。キーの並べ替え自体を一律の解決策にしない
- 対象地域/サービスと署名スコープのRegionが不一致。単一リージョンへ一律固定しない
エラー3: RequestThrottled / TooManyRequests
旧記事にあった次表は現行の利用枠ではありません。対象API/ストアの正式な枠を確認し、旧数値や固定換算から増枠を推測しないでください:
| 制限 | 初期値 | 備考 |
|---|---|---|
| TPS (Transactions Per Second) | 1 TPS | 1 秒に 1 リクエスト |
| 1 日のリクエスト数 | 8,640 件 | 1 TPS × 86,400 秒の 1/10 程度 |
| 売上連動増加 | 固定の売上換算で推定しない | 現在の対象アカウントの枠を確認 |
| 新規アカウント | 申請審査とAPI資格は別 | 利用停止の原因を売上だけで判断しない |
次は旧再試行コードの保存例です。例外メッセージの部分一致だけで再試行を決める完成実装ではありません。 正式なHTTP/エラーコード、待機指示・上限・期限を確認し、廃止や認証の403を無条件に再送しないでください:
function callWithRetry($callback, $maxRetries = 5) {
$delay = 1;
for ($i = 0; $i < $maxRetries; $i++) {
try {
return $callback();
} catch (Exception $e) {
if (strpos($e->getMessage(), "RequestThrottled") !== false ||
strpos($e->getMessage(), "TooManyRequests") !== false) {
sleep($delay);
$delay *= 2; // 1, 2, 4, 8, 16 秒
continue;
}
throw $e;
}
}
throw new Exception("Max retries exceeded");
}
// 使用例
$result = callWithRetry(function() use ($api, $request) {
return $api->searchItems($request);
});
エラー4: AccessDeniedException
「アクセスが拒否されました」だけでアソシエイト資格の問題とは断定できません。公式のPA-API 5廃止案内でも403 AccessDeniedExceptionの例があります:
- 対象APIの提供状況 → PA-API 5廃止か、現在のCreators APIかを最初に特定
- 利用資格 → 審査・承認・対象ストアとの対応を確認。売上1件で復活とは扱わない
- アカウント状態 → 管理画面の正式な通知を確認。403だけから違反を断定しない
- 認証情報の対応 → 旧AWSキーとCreators API資格情報を混用せず対象ストアを照合
確認: https://affiliate.amazon.co.jp から対象ストアの管理画面と正式通知を確認します。現行Creators APIの登録・資格情報と、旧PA-APIの画面を区別してください。
エラー5: ItemNotAccessible
商品が API でアクセスできない:
- 地域限定商品: 日本マーケットからは見えない海外限定品
- 廃番: ASIN は存在するが販売終了
- 大人カテゴリ: 一部の制限付きカテゴリは API で取得不可
- Marketplace 不一致:
.co.jpのキーで.comの ASIN を取得しようとした
PA-API 4.0 → 5.0 移行時のエラー
| 変更点 | 4.0 | 5.0 |
|---|---|---|
| エンドポイント | ecs.amazonaws.jp | webservices.amazon.co.jp/paapi5/ |
| プロトコル | GET + クエリ文字列 | POST + JSON |
| 署名 | SigV2 | SigV4 |
| 操作名 | ItemSearch / ItemLookup | SearchItems / GetItems |
| レスポンス | XML | JSON |
| SDK | 独自実装 | 公式 SDK 各言語 |
旧SDKの例(現在の導入には使わない)
以下のComposer/pip/npmコマンドや名前空間は旧記事の原資料で、現在の公式配布や正しさを検証していません。実行を勧めません。 続くPHPもimport/設定/エラー処理を網羅しない断片です。生の例外を公開画面へ出さないでください。現行導入はCreators APIの公式SDK案内を確認します:
# PHP の場合
composer require amazon-paapi5/paapi5-php-sdk
# Python
pip install paapi5-python-sdk
# JavaScript (Node.js)
npm install paapi5-nodejs-sdk
# Java
# Maven 経由で paapi5-java-sdkuse Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\api\DefaultApi;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsRequest;
$config = new Configuration();
$config->setAccessKey("AKIA...");
$config->setSecretKey("xxxxxxxx");
$config->setHost("webservices.amazon.co.jp");
$config->setRegion("us-west-2");
$apiInstance = new DefaultApi(new GuzzleHttp\Client(), $config);
$request = new SearchItemsRequest();
$request->setPartnerTag("yourtag-22");
$request->setPartnerType(PartnerType::ASSOCIATES);
$request->setKeywords("Harry Potter");
$request->setSearchIndex("All");
$request->setResources([
SearchItemsResource::ITEM_INFOTITLE,
SearchItemsResource::OFFERSLISTINGSPRICE
]);
try {
$response = $apiInstance->searchItems($request);
// 成功
} catch (ApiException $e) {
echo "Error: " . $e->getMessage();
}
FAQ
Q: 売上ゼロで API が止まった
A: 売上1件で数日後に自動復活するとは言えません。旧PA-APIの廃止と、現在の対象API・アカウントの利用資格を分けて確認します。登録/申請の案内は資格情報の記事も参照してください。
Q: TPS をもっと増やしたい
A: 対象APIの現在の枠と申請手順を公式案内で確認します。旧数式から増枠を約束したり、手動申請の可否を全サービス共通としたりしません。
Q: PA-API 4.0 のコードはまだ動く?
A: 4.0を現在の利用先にはできません。5.0も廃止案内対象で、現在の連携はCreators APIへの移行を確認します。旧コードの操作名だけの変更では足りません。
Q: 開発環境(Sandbox)はある?
A: 現行の検証手段は対象サービスの公式案内を確認します。エラー再現のため本番へ無制限に要求を送らず、ローカルの保存済み応答・モックで異常系を先に検査します。この記事では実資格情報による通信は行っていません。
- Error 400 : Bad Request Parameter Operation is missing
- MissingParameter. The request must contain the parameter Signature.
- RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
- SignatureDoesNotMatch. The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. Consult the service documentation for details.
- failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスのソフト一覧|Blender・Metasequoiaと用途別の選び方
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- Visual Studio「デザイナーを表示できません」エラーの原因と対処 2026-10-28 12:06:00
- SSH 認証に失敗しました。再試行してください の対処 2026-10-28 12:06:00
- SSH2 秘密鍵の読み込みに失敗しました の原因と対処 2026-10-28 12:06:00
- TeraTerm のよくあるエラーと対処法完全ガイド — Connection refused / 2026-10-28 12:06:00
- Visual Studio エラー一覧|コンパイルエラー・警告の確認方法と対処 2026-10-28 11:39:57
- Whitelabel Error Page の原因と消し方|Spring Boot のエラーページ 2026-10-28 11:39:57
- Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法 2026-10-28 11:39:57
- SQL WHERE 句完全ガイド 2026-10-28 11:39:57
- SQL JOIN 完全ガイド (INNER/LEFT/RIGHT/FULL OUTER) 2026-10-28 11:39:57
- tomcat の起動 / 停止ログと catalina.log・catalina.out の違い 2026-10-28 10:24:23
- Tomcat の起動確認方法 5 つ|localhost:8080・ポート・プロセス・ログ 2026-10-28 10:24:23
- Oracle 19c COMMITの使い方: 暗黙コミット・自動確定・応答不明時の確認 2026-10-28 09:59:09
- Oracle 19c DELETE文|削除対象の確認・COMMIT前の判断・ROLLBACKの条件 2026-10-28 09:59:09
- Oracle 19c INSERT文|INSERT ALL・SELECT・RETURNINGとMERGEの使い分け 2026-10-28 09:59:09
- Oracle 19cのトランザクション制御|COMMIT・ROLLBACK・分離レベルと接続設定 2026-10-28 09:59:09