您可以通过向 Offer Library API
有关JSON修补程序(包括可用操作)的更多信息,请参阅 JSON修补程序文档.
下表显示构成 Content-Type 和 接受 请求标题中的字段:
标题名称 | 值 |
---|---|
Accept | application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1 |
Content-Type | Content-Type: application/vnd.adobe.platform.xcore.patch.hal+json; version=1; schema="https://ns.adobe.com/experience/offer-management/personalized-offer;version=0.5" |
API格式
PATCH /{ENDPOINT_PATH}/{CONTAINER_ID}/instances/{INSTANCE_ID}
参数 | 描述 | 示例 |
---|---|---|
{ENDPOINT_PATH} |
存储库API的端点路径。 | https://platform.adobe.io/data/core/xcore/ |
{CONTAINER_ID} |
个性化选件所在的容器。 | e0bd8463-0913-4ca1-bd84-6309134ca1f6 |
请求
curl -X PATCH \
'https://platform.adobe.io/data/core/xcore/e0bd8463-0913-4ca1-bd84-6309134ca1f6/instances/0f4bc230-13df-11eb-bc55-c11be7252432' \
-H 'Accept: application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1' \
-H 'Content-Type: Content-Type: application/vnd.adobe.platform.xcore.patch.hal+json; version=1; schema="https://ns.adobe.com/experience/offer-management/personalized-offer;version=0.5"' \
-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}'\
-d '[
{
"op": "add",
"path": "/_instance/xdm:representations/-",
"value": {
"xdm:placement": "xcore:offer-placement:124e0be5699743d3",
"xdm:components": [
{
"@type": "https://ns.adobe.com/experience/offer-management/content-component-text",
"dc:format": "text/plain",
"dc:language": ["en"],
"xdm:content": "Here is your first sale offer!"
}
]
}
}
]'
参数 | 描述 |
---|---|
op |
操作调用,用于定义更新连接所需的操作。 操作包括: add , replace 和 remove . |
path |
要更新的参数的路径。 |
value |
要使用更新参数的新值。 |
响应
成功的响应会返回个性化选件的更新详细信息,包括其唯一实例ID和个性化选件 @id
.
{
"instanceId": "0f4bc230-13df-11eb-bc55-c11be7252432",
"@id": "xcore:personalized-offer:124e181c8b0d7878",
"repo:etag": 1,
"repo:createdDate": "2020-10-21T20:50:32.018624Z",
"repo:lastModifiedDate": "2020-10-21T20:50:32.018624Z",
"repo:createdBy": "{CREATED_BY}",
"repo:lastModifiedBy": "{MODIFIED_BY}",
"repo:createdByClientId": "{CREATED_CLIENT_ID}",
"repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"
}