设置 API 访问 setting-up-api-access

Adobe Campaign Standard API访问可通过以下步骤进行设置。 Adobe Developer文档中详细介绍了这些步骤。

IMPORTANT
若要在Adobe Developer中管理证书,请确保您对该组织具有​ 系统管理员 ​权限,或者在Admin Console中具有开发人员帐户
  1. 检查您是否拥有数字证书,或者在必要时创建一个数字证书。 以下步骤需要随证书一起提供的公钥和私钥。

  2. Adobe Developer中创建与Adobe Campaign服务 ​的新集成并进行配置。 随后将生成您的凭据(API密钥、客户端密钥……)。

  3. 使用之前生成的凭据创建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身份验证的所有元素:
  4. 通过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参数是否正确创建。

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff