验证模板化的客户字段
概述 overview
/authoring/testing/template/render端点帮助您可视化目标配置中定义的模板化客户数据字段的外观。
端点会为客户数据字段生成随机值，并在响应中返回这些值。 这有助于您验证客户数据字段的语义结构，例如存储段名称或文件夹路径。
快速入门 getting-started
在继续之前，请查看入门指南以了解成功调用API所需了解的重要信息，包括如何获取所需的目标创作权限和所需的标头。
先决条件 prerequisites
在使用/template/render端点之前，请确保您满足以下条件：
-
您有一个通过Destination SDK创建的基于文件的现有目标，您可以在目标目录中看到该目标。
-
要成功发出API请求，您需要与要测试的目标实例对应的目标实例ID。 在Platform UI中浏览与目标之间的连接时，从URL获取应在API调用中使用的目标实例ID。
呈现模板化的客户字段 render-customer-fields
API格式
POST /authoring/testing/template/render/destination
为了说明此API端点的行为，让我们考虑使用以下客户数据字段配置的基于文件的目标：
"fileBasedS3Destination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
请求
以下请求调用/authoring/testing/template/render端点，该端点返回一个响应，其中具有上面提到的两个客户数据字段的随机生成值。
curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/template/render/destination' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"destinationId": "{DESTINATION_CONFIGURATION_ID}",
"templates": {
"bucket": "{{customerData.bucket}}",
"path": "{{customerData.bucket}}/{{customerData.path}}"
}
}'
响应
成功的响应返回HTTP 200 OK状态，正文包括为模板化字段随机生成的值。
此响应可帮助您验证客户数据字段的正确结构，如存储段名称或文件夹路径。
{
"results": {
"bucket": "hfWpE-bucket",
"path": "hfWpE-bucket/ceC"
}
}
API错误处理 api-error-handling
Destination SDKAPI端点遵循常规Experience PlatformAPI错误消息原则。 请参阅平台疑难解答指南中的API状态代码和请求标头错误。
后续步骤 next-steps
阅读本文档后，您现在知道如何验证目标服务器中定义的客户数据字段配置。