必读 must-read

技术要求

  • Adobe Campaign API必须仅用于“服务器到服务器”。
  • 如果您要实施的用例与Adobe Campaign API允许的规模一致,请始终与您的Adobe技术联系人核实。
  • 设置AdobeIO访问需要特定权限,如果遇到任何问题,请与Adobe支持部门联系。

权限和访问

  • 默认情况下,Adobe Campaign API使用管理员上下文,因此组织单位和角色不适用。
  • Adobe Campaign API将从角色上下文中排除。
  • 如果要使用一个或多个组织单位配置API,请与联系以Adobe技术联系人。

资源表示

所有API资源都可在​ JSON ​中使用,扩展名为URL,或位于HTTP接受标头内:

GET /profileAndServices/<resourceName>.json

NOTE
在URL中没有扩展名,json格式是内容类型的默认格式

请求样本

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile.json \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

主键和URL

  • 不要尝试自己构建URL。 所有URL均由API返回。 但是,可以根据顶级资源名称构建URL。

  • 说明示例的自动主键(PKey)值不适用于其他特定部署。 它们由Adobe Campaign API生成。

  • 绝不能将Adobe Campaign生成的自动主键值存储到外部数据库或网站中。 您必须在数据库定义中生成特定的键字段,并在开发过程中使用它。

自定义密匙 custom-keys

如果用户档案资源已通过自定义键字段扩展,则可以使用此字段作为键,而不是Adobe Campaign生成的自动主键:

GET /.../profileAndServicesExt/profile/<customKey>

如果密钥值与原始密钥不同,或者您将自己的业务密钥用作URI而不是Adobe提供的业务密钥,则无法使用PATCH操作修改自定义密钥。

仅对​ 顶层配置文件资源 ​使用自定义键。 URL由API返回,绝不应该自行构建。

示例请求

要使用自定义键检索用户档案的订阅,请对自定义键执行GET操作。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/<customKey> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

对返回的订阅URL执行GET请求。

-X GET <SUBSCRIPTION_URL> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

它会返回用户档案的订阅列表。

"service": {
"PKey": "<PKEY>",
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>",
"label": "Sport Newsletter",
"name": "SVC1",
"title": "Sport Newsletter (SVC1)"
}
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff