タイトル: 署名認証の方法(PHPサンプル ItemSearch)
SEOタイトル: Amazon PA-API 5.0 の AWS V4 署名を PHP で生成(SDK 利用 / 自前 hash_hmac 両方)
旧ItemSearchとPA-API 5の署名資料を読むためのページです。PA-API 5も廃止案内対象なので、現在の商品API連携へそのまま貼り付けないでください。
2026年10月確認: PA-API 5.0も移行が必要
PA-API 5.0を現在の新規導入先として勧める説明は更新が必要です。 Amazon公式はPA-API 5の廃止と後継Creators APIへの移行を案内し、旧PA-API 5への要求に403 AccessDeniedExceptionが返る例を示しています。これは署名を調整すれば利用を再開できる、という案内ではありません。
公式の廃止案内と移行ガイドを先に確認してください。Creators APIはOAuth 2.0を使い、旧PA-APIのAWS Access Key / Secret Keyはそのまま利用できません。Credential ID / Credential Secretと対象の資格情報Versionを取得し、APIの送信先・ヘッダー・項目名も変更します。秘密情報をこのページや問い合わせへ貼り付けないでください。
| この記事の要点 |
|
PA-API 5.0 とは
Amazon Product Advertising API は商品検索・取得用 API。旧4.0のXML/ItemSearchと、5.0のJSON/SearchItemsは別のAPI世代です。旧4.0の稼働を確認する導入手順ではありません。ここに残すサンプルは旧PA-API 5.0(JSON、AWS V4署名)の参考資料です。5.0も現在は廃止案内対象で、後継Creators APIのOAuth 2.0連携例ではありません。タイトルにあるItemSearchと、下のSearchItemsも別の操作です。
必要なクレデンシャル
| 項目 | 取得元 | 例 |
|---|---|---|
| Access Key | Amazon アソシエイト管理画面 | AKIAxxxxxxxxxxxxxxxx |
| Secret Key | 同上(発行時のみ表示) | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| Partner Tag | アソシエイト ID | myassoc-22 |
| Marketplace | 対象国 | 日本: www.amazon.co.jp |
| Host | API ホスト名 | 日本: webservices.amazon.co.jp |
| Region | AWS 風リージョン | 日本: us-west-2 (マーケット別に決まる) |
方法1: 旧SDKの例(現在の導入には使わない)
下のコードは旧記事の原資料です。 記載のComposerコマンド・名前空間の正しさや現行の公式配布を保証するものではなく、実行を勧めません。現行SDKはCreators APIの公式案内から確認してください。旧SDKの資格情報だけを変更して動くとは扱いません。
# Composer で導入
composer require amazon-paapi5/sdk-php<?php
require __DIR__ . '/vendor/autoload.php';
use Amazon\ProductAdvertisingAPI\v1\ApiException;
use Amazon\ProductAdvertisingAPI\v1\Configuration;
use Amazon\ProductAdvertisingAPI\v1\api\DefaultApi;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsRequest;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsResource;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\PartnerType;
$config = new Configuration();
$config->setAccessKey('AKIAxxxxxxxxxxxxxxxx');
$config->setSecretKey('xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');
$config->setHost('webservices.amazon.co.jp');
$config->setRegion('us-west-2');
$apiInstance = new DefaultApi(new GuzzleHttp\Client(), $config);
$req = new SearchItemsRequest();
$req->setPartnerTag('myassoc-22');
$req->setPartnerType(PartnerType::ASSOCIATES);
$req->setKeywords('ルアー');
$req->setSearchIndex('All');
$req->setItemCount(10);
$req->setResources([
SearchItemsResource::ITEM_INFOTITLE,
SearchItemsResource::OFFERSLISTINGSPRICE,
SearchItemsResource::IMAGESPRIMARYMEDIUM,
]);
try {
$resp = $apiInstance->searchItems($req);
foreach ($resp->getSearchResult()->getItems() as $item) {
echo $item->getASIN() . "\t"
. $item->getItemInfo()->getTitle()->getDisplayValue() . "\n";
}
} catch (ApiException $e) {
echo "Error: " . $e->getMessage() . "\n";
echo "Response: " . $e->getResponseBody() . "\n";
}
方法2: 自前で AWS V4 署名を生成
次は廃止API向けの未実行サンプルとして保持します。 実資格情報を設定して呼び出す現行手順ではありません。下のコードはHTTP失敗・タイムアウト・不正JSON・レスポンス内エラー等を網羅せず、画面への生の例外出力もそのまま使わないでください。
日付をgmdateで別々に取得するとUTCの日付境界をまたぐ可能性があります。SigV4を学習するなら同じ時点からx-amz-dateとスコープ日付を作り、署名時と送信時の本文を同じバイト列にします。タイムアウト等を追加しても廃止済みPA-APIが復活するわけではありません。
学習や軽量化のため自前実装する場合。AWS V4 署名の手順は次の 4 ステップです:
<?php
// ===== 設定 =====
$accessKey = 'AKIAxxxxxxxxxxxxxxxx';
$secretKey = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
$partnerTag = 'myassoc-22';
$host = 'webservices.amazon.co.jp';
$region = 'us-west-2';
$service = 'ProductAdvertisingAPI';
$path = '/paapi5/searchitems';
$target = 'com.amazon.paapi5.v1.ProductAdvertisingAPIv1.SearchItems';
// ===== リクエスト body =====
$payload = json_encode([
'Keywords' => 'ルアー',
'PartnerTag' => $partnerTag,
'PartnerType' => 'Associates',
'Marketplace' => 'www.amazon.co.jp',
'Resources' => [
'ItemInfo.Title',
'Offers.Listings.Price',
'Images.Primary.Medium',
],
]);
// ===== タイムスタンプ =====
$amzDate = gmdate('Ymd\THis\Z'); // 20260517T120000Z
$dateStamp = gmdate('Ymd'); // 20260517
// ===== Canonical Request =====
$canonicalUri = $path;
$canonicalQueryString = '';
$canonicalHeaders =
"content-encoding:amz-1.0\n" .
"content-type:application/json; charset=utf-8\n" .
"host:$host\n" .
"x-amz-date:$amzDate\n" .
"x-amz-target:$target\n";
$signedHeaders = 'content-encoding;content-type;host;x-amz-date;x-amz-target';
$payloadHash = hash('sha256', $payload);
$canonicalRequest =
"POST\n" .
"$canonicalUri\n" .
"$canonicalQueryString\n" .
"$canonicalHeaders\n" .
"$signedHeaders\n" .
"$payloadHash";
// ===== String to Sign =====
$algorithm = 'AWS4-HMAC-SHA256';
$credentialScope = "$dateStamp/$region/$service/aws4_request";
$stringToSign =
"$algorithm\n" .
"$amzDate\n" .
"$credentialScope\n" .
hash('sha256', $canonicalRequest);
// ===== Signing Key 派生 =====
$kDate = hash_hmac('sha256', $dateStamp, 'AWS4' . $secretKey, true);
$kRegion = hash_hmac('sha256', $region, $kDate, true);
$kService = hash_hmac('sha256', $service, $kRegion, true);
$kSigning = hash_hmac('sha256', 'aws4_request', $kService, true);
// ===== Signature =====
$signature = hash_hmac('sha256', $stringToSign, $kSigning);
// ===== Authorization ヘッダ =====
$authHeader =
"$algorithm Credential=$accessKey/$credentialScope, " .
"SignedHeaders=$signedHeaders, " .
"Signature=$signature";
// ===== HTTP リクエスト =====
$ch = curl_init("https://$host$path");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: $authHeader",
"Content-Encoding: amz-1.0",
"Content-Type: application/json; charset=utf-8",
"Host: $host",
"X-Amz-Date: $amzDate",
"X-Amz-Target: $target",
],
]);
$body = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "HTTP $code\n";
$data = json_decode($body, true);
foreach (($data['SearchResult']['Items'] ?? []) as $it) {
echo $it['ASIN'] . "\t" . ($it['ItemInfo']['Title']['DisplayValue'] ?? '') . "\n";
}
署名計算の落とし穴
| ハマりどころ | 対処 |
|---|---|
| ヘッダ名は小文字でソート済が必須 | host, x-amz-date 等。アルファベット順 |
SignedHeaders と Canonical Headers の対象を一致 | セミコロン区切り、同じ並び |
| payload hash は正確な送信 bodyのハッシュ | json_encode の改行・空白に注意 |
| タイムスタンプは UTC | gmdate() 使用、ローカルタイムは NG |
| 日時ずれを確認。許容時間やエラー名を全サービス共通の5分と断定しない | NTP で時刻同期 |
レスポンス例
{
"SearchResult": {
"Items": [
{
"ASIN": "B08XXXXX",
"DetailPageURL": "https://www.amazon.co.jp/dp/B08XXXXX?tag=myassoc-22",
"ItemInfo": {
"Title": { "DisplayValue": "...ルアー...", "Label": "Title", "Locale": "ja_JP" }
},
"Offers": {
"Listings": [
{ "Price": { "Amount": 1980, "Currency": "JPY", "DisplayAmount": "¥1,980" } }
]
}
}
]
}
}
FAQ
Q: 旧 ItemSearch (PA-API 4.0) サンプルはまだ使える?
A: 使えません。エンドポイントが廃止済。PA-API 5も廃止案内対象のため、現在の連携はCreators APIへの移行を確認してください。
Q: TooManyRequests エラー
A: 対象APIのエラーコードと現行の利用枠を確認します。旧PA-APIの数値をCreators APIの現在の上限としないでください。廃止による403を再試行して解消しようとせず、移行案内を確認します。
Q: InvalidSignature が出る
A: Canonical Request の改行コード(LF 必須)、ヘッダの並びと小文字化、payload hash のずれを順に確認。
Creators APIへ切り替える際の確認
移行はSigV4関数の差し替えだけではありません。公式SDKの配布物と例を使い、Credential ID / Secret / Version、対象MarketplaceとPartner Tag、認証トークンの管理、操作・項目名の変化を確認します。旧キーをブラウザーへ渡したり、PHPコードへ実値を埋め込んで公開したりしないでください。
このページでは旧SDKのインストール、PA-APIやCreators APIへの実通信を検証していません。旧コードは処理内容の比較用に保持していますが、現行の完成実装とは扱いません。