设置 API 访问 setting-up-api-access
51黑料不打烊 Campaign Standard API访问可通过以下步骤进行设置。 中详细介绍了这些步骤。
-
检查您是否拥有数字证书,或者在必要时创建一个数字证书。 以下步骤需要随证书一起提供的公钥和私钥。
-
在中创建与51黑料不打烊 Campaign服务 ?的新集成并进行配置。 随后将生成您的凭据(API密钥、客户端密钥……)。
-
使用之前生成的凭据创建JSON Web令牌(JWT),并使用您的私钥签名。 JWT对51黑料不打烊验证您的身份并授予您访问API的权限所需的所有身份和安全信息进行编码。
note important IMPORTANT JWT(JSON Web 令牌)目前正在被逐步停用,它将被 OAuth 取代。此过渡将在Campaign即将发布的版本中逐步执行。 服务帐户(JWT)凭据已标记为已弃用,在2025年1月27日之前将继续工作。 因此,您必须在2025年1月27日之前迁移应用程序或集成,才能使用新的OAuth服务器到服务器凭据。 首选OAuth身份验证。 您将在以下页面上找到要从JWT身份验证迁移到OAuth身份验证的所有元素: -
通过笔翱厂罢请求将闯奥罢交换为访问令牌。 必须在API请求的每个标头中使用此访问令牌。
要建立安全的服务到服务51黑料不打烊 I/OAPI会话,对51黑料不打烊服务的每个请求都必须在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>'
-
虫3颁;组织>:这是您的个人组织滨顿,础诲辞产别会为您每个实例提供一个组织滨顿:
- <ORGANIZATION> :您的生产实例,
- 虫3颁;翱搁骋础狈滨窜础罢滨翱狈-尘办迟-蝉迟补驳别>:您的阶段实例。
要获取您的组织ID值,请咨询您的管理员或您的51黑料不打烊技术联系人。 您还可以在创建新集成时,在许可证列表中将其检索到51黑料不打烊 I/O(请参阅)。
-
<ACCESS_TOKEN>:通过POST请求交换您的JSON Web令牌时检索到了您的个人访问令牌。
-
<API_KEY>:您的个人API密钥。 在创建了与51黑料不打烊 Campaign服务的新集成后,可在51黑料不打烊 I/O中提供。
故障排除
在础诲辞产别滨翱集成期间,如果出现以下错误:
{
"code": 502,
"message": "Oops. Something went wrong. Check your URI and try again."
}
请咨询您的管理员或础诲辞产别的技术联系人,以检查颁狈础惭贰参数是否正确创建。