本文档旨在帮助开发者解决在使用 Amazon Advertising API 创建关键词时遇到的 422 错误。该错误通常表示请求体中的数据格式不正确。本文将通过示例代码，详细介绍如何正确构建请求体，避免此类错误，并提供一些调试建议。
在使用 Amazon Advertising API 创建关键词时，开发者可能会遇到 HTTP 状态码 422，表示请求体中的数据格式不符合 API 的预期。 这个问题通常出现在使用 POST 方法向 /v2/sp/keywords 端点发送请求时。
问题分析
422 错误通常意味着请求体中的 JSON 结构不正确。Amazon Advertising API 对于创建关键词的请求，期望接收一个包含关键词对象的数组，而不是单个关键词对象。
解决方案
正确的做法是将关键词对象放置在一个数组中。以下示例代码展示了如何修改 PHP 代码以解决这个问题。
示例代码 (PHP)
"111111111111",
"adGroupId" => "2222222222222",
"state" => "enabled",
"keywordText" => "YetAnotherKeyword",
"matchType" => "broad",
"bid" => "0.05"
));
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data_string)); // 确保将数组编码为 JSON 字符串
$headers = array();
$headers[] = "Content-Type: application/json";
$headers[] = ("Authorization: Bearer " . $accesstoken);
$headers[] = ("Amazon-Advertising-API-ClientId: " . $client);
$headers[] = ("Amazon-Advertising-API-Scope: " . $API_Scope);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error:' . curl_error($ch);
}
curl_close($ch);
echo $result;
?>代码解释：
- 数组结构： 关键在于 $data_string 变量。它现在是一个包含单个数组元素的数组，该元素本身是一个包含关键词信息的关联数组。
- JSON 编码： 使用 json_encode() 函数将 PHP 数组转换为 JSON 字符串。这是 Amazon Advertising API 所期望的格式。
- 替换占位符： 务必将 YOUR_API_ENDPOINT、YOUR_ACCESS_TOKEN、YOUR_CLIENT_ID 和 YOUR_API_SCOPE 替换为你的实际值。
注意事项：
- Content-Type： 确保在请求头中设置 Content-Type: application/json，告诉 API 你发送的是 JSON 数据。
- 错误处理： 始终检查 curl_errno($ch) 的值，以确保请求没有发生错误。
- 数据验证： 在发送请求之前，验证所有必需的字段都已设置，并且具有正确的数据类型。 例如，campaignId 和 adGroupId 应该是字符串，而 bid 应该是数字。
- API 文档： 参考 Amazon Advertising API 的官方文档，了解最新的请求格式和参数要求。
调试建议：
- 打印请求体： 在发送请求之前，使用 var_dump($data_string) 或 print_r($data_string) 打印请求体，以确保其结构正确。
- 使用 Postman 或 Insomnia： 使用这些工具手动构建和发送 API 请求，可以更方便地调试请求体和请求头。
- 查看 API 响应： 仔细查看 API 返回的错误信息，通常会提供有关错误的更多详细信息。
总结
解决 Amazon Advertising API 返回的 422 错误的关键在于确保请求体中的 JSON 结构符合 API 的预期。 通过将关键词对象放置在一个数组中，并使用 json_encode() 函数将其编码为 JSON 字符串，可以避免此错误。 此外，请务必参考 API 文档，并仔细检查请求头和请求体中的所有字段。 遵循这些建议，可以有效地解决在使用 Amazon Advertising API 创建关键词时遇到的问题。
