本开发人员指南提供了一些步骤,帮助您开始使用 Offer Library API。 然后,该指南提供了使用决策引擎执行关键操作的示例API调用。
本指南要求您对Adobe Experience Platform的以下组件有一定的了解:
本指南提供了示例API调用,以演示如何设置请求的格式。 这些资源包括路径、必需的标头和格式正确的请求负载。 此外,还提供了在API响应中返回的示例JSON。 有关示例API调用文档中使用的约定的信息,请参阅以下章节: 如何读取示例API调用 在 Experience Platform 疑难解答指南。
为了调用 Adobe Experience Platform API,您必须先完成 身份验证教程. 完成身份验证教程将提供所有中所有所需标头的值 Experience Platform API调用,如下所示:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
包含有效负载(POST、PUT、PATCH)的所有请求都需要额外的标头:
Content-Type: application/json
容器是一种隔离机制,用于分隔不同的关注点。 容器ID是所有存储库API的第一个路径元素。 所有决策对象都驻留在容器中。
管理员可以将相似的主体、资源和访问权限分组到配置文件中。 这减轻了管理负担,并得到了以下支持 Adobe Admin Console. 您必须是组织中Adobe Experience Platform的产品管理员,才能创建配置文件并将用户分配给这些用户。 只需在一次性步骤中创建与特定权限匹配的产品配置文件,然后只需将用户添加到这些配置文件即可。 用户档案充当已授予权限的组,该组中的每个实际用户或技术用户都会继承这些权限。
授予管理员权限,您可以通过授予或撤销用户权限 Adobe Admin Console. For more information, see the Access control overview.
API格式
GET /{ENDPOINT_PATH}?product={PRODUCT_CONTEXT}&property={PROPERTY}==decisioning
参数 | 描述 | 示例 |
---|---|---|
{ENDPOINT_PATH} |
存储库API的端点路径。 | https://platform.adobe.io/data/core/xcore/ |
{PRODUCT_CONTEXT} |
按容器与产品上下文的关联筛选容器列表。 | acp |
{PROPERTY} |
筛选返回的容器类型。 | _instance.containerType==decisioning |
请求
curl -X GET \
'https://platform.adobe.io/data/core/xcore/?product=acp&property=_instance.containerType==decisioning' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
响应
成功的响应将返回有关决策管理容器的信息。 这包括 instanceId
属性,其值是您的容器ID。
{
"_embedded": {
"https://ns.adobe.com/experience/xcore/container": [
{
"instanceId": "{INSTANCE_ID}",
"schemas": [
"https://ns.adobe.com/experience/xcore/container;version=0.5"
],
"productContexts": [
"acp"
],
"repo:etag": 2,
"repo:createdDate": "2020-09-16T07:54:28.319959Z",
"repo:lastModifiedDate": "2020-09-16T07:54:32.098139Z",
"repo:createdBy": "{CREATED_BY}",
"repo:lastModifiedBy": "{MODIFIED_BY}",
"repo:createdByClientId": "{CREATED_CLIENT_ID}",
"repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}",
"_instance": {
"containerType": "decisioning",
"repo:name": "{REPO_NAME}",
"dataCenter": "{DATA_CENTER}",
"parentName": "{PARENT_NAME}",
"parentId": "{PARENT_ID}"
},
"_links": {
"self": {
"href": "/containers/{INSTANCE_ID}"
}
}
}
]
},
"_links": {
"self": {
"href": "/?product=acp&property=_instance.containerType==decisioning",
"@type": "https://ns.adobe.com/experience/xcore/hal/home"
}
}
}
本文档介绍了调用 Offer Library API,包括获取容器ID。 您现在可以继续本开发人员指南中提供的示例调用,并按照其说明进行操作。
以下视频旨在帮助您了解决策管理的各个组件。