◀ 5.

旧Amazon PA-APIのエラー一覧|廃止・認証・レート制限の確認

▶

Amazon旧PA-APIのエラーを、現在のCreators APIと混同せず読むための一覧です。子ページから個別エラーを選択してください。 コード例は保守資料として残し、現在の導入・利用再開を保証する手順とは分けます。

旧PA-APIの世代と後継Creators APIの認証を区別する図

最初に確認する順序

  1. PA-API 5廃止案内を確認し、呼出先が旧APIか現在のCreators APIかを特定する。
  2. 接続/タイムアウト、HTTP状態、本文内コードを分ける。401/403をレート超過として繰り返し送信しない。
  3. 現在の認証は公式移行ガイドに従い、旧AWSキーから専用資格情報とOAuthへ切り替える。
  4. 現行のエラー資料と対象操作を照合する。AuthorizationやSecret、生の応答を公開質問へ貼らない。

個別エラーの子ページ

各子ページの旧例は、そのAPI世代の資料として参照します。個別記事もすべて現行Creators APIへ更新済み、という意味ではありません。親の関連資料から要求や応答の説明へも進めます。

この記事の要点
  • InvalidParameterValue = リクエストパラメータの値が不正。ASIN・国コード等の typo
  • MissingParameterは必須項目不足、InvalidSignatureは署名検証の問題。名前の違うエラーを同一原因としない
  • RequestThrottled / TooManyRequestsは対象APIのレート枠・並列数・応答コードを照合。再試行の可否と上限を確認
  • AccessDeniedExceptionは旧PA-API 5廃止でも案内される。売上不足だけを原因と断定しない
  • 4.0も5.0も旧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結果ゼロ検索キーワード合致なし
InvalidPartnerTagPartnerTag 不正登録外のタグ使用

エラー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 TPS1 秒に 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.05.0
エンドポイントecs.amazonaws.jpwebservices.amazon.co.jp/paapi5/
プロトコルGET + クエリ文字列POST + JSON
署名SigV2SigV4
操作名ItemSearch / ItemLookupSearchItems / GetItems
レスポンスXMLJSON
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-sdk
use 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: 現行の検証手段は対象サービスの公式案内を確認します。エラー再現のため本番へ無制限に要求を送らず、ローカルの保存済み応答・モックで異常系を先に検査します。この記事では実資格情報による通信は行っていません。

子ページ
  1. Error 400 : Bad Request Parameter Operation is missing
  2. MissingParameter. The request must contain the parameter Signature.
  3. RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
  4. 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.
  5. failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable
同階層のページ
  1. アカウントの作成とキーの生成
  2. PA-APIの使い方 リクエストの構造とパラメータの指定
  3. リクエストにスペースを含める方法
  4. 署名認証の方法(PHPサンプル ItemSearch)
  5. エラー一覧
  6. レスポンスの構造(ItemSearch)

最近更新/作成されたページ