设置 API 访问 setting-up-api-access
Adobe Campaign Standard API访问可通过以下步骤进行设置。 Adobe Developer文档中详细介绍了这些步骤。
-
检查您是否拥有数字证书，或者在必要时创建一个数字证书。 以下步骤需要随证书一起提供的公钥和私钥。
-
在Adobe Developer中创建与Adobe Campaign服务 的新集成并进行配置。 随后将生成您的凭据（API密钥、客户端密钥……）。
-
使用之前生成的凭据创建JSON Web令牌(JWT)，并使用您的私钥签名。 JWT对Adobe验证您的身份并授予您访问API的权限所需的所有身份和安全信息进行编码。
note important IMPORTANT JWT（JSON Web 令牌）目前正在被逐步停用，它将被 OAuth 取代。此过渡将在Campaign即将发布的版本中逐步执行。 服务帐户(JWT)凭据已标记为已弃用，在2025年1月27日之前将继续工作。 因此，您必须在2025年1月27日之前迁移应用程序或集成，才能使用新的OAuth服务器到服务器凭据。 首选OAuth身份验证。 您将在以下页面上找到要从JWT身份验证迁移到OAuth身份验证的所有元素： -
通过POST请求将JWT交换为访问令牌。 必须在API请求的每个标头中使用此访问令牌。
要建立安全的服务到服务Adobe I/OAPI会话，对Adobe服务的每个请求都必须在Authorization标头中包含以下信息。
-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'
-
<组织>：这是您的个人组织ID，Adobe会为您每个实例提供一个组织ID：
- <ORGANIZATION> ：您的生产实例，
- <ORGANIZATION-mkt-stage>：您的阶段实例。
要获取您的组织ID值，请咨询您的管理员或您的Adobe技术联系人。 您还可以在创建新集成时，在许可证列表中将其检索到Adobe I/O(请参阅Adobe Developer文档)。
-
<ACCESS_TOKEN>：通过POST请求交换您的JSON Web令牌时检索到了您的个人访问令牌。
-
<API_KEY>：您的个人API密钥。 在创建了与Adobe Campaign服务的新集成后，可在Adobe I/O中提供。
故障排除
在AdobeIO集成期间，如果出现以下错误：
{
"code": 502,
"message": "Oops. Something went wrong. Check your URI and try again."
}
请咨询您的管理员或Adobe的技术联系人，以检查CNAME参数是否正确创建。