验证模板化客户字段

概述

的 /authoring/testing/template/render 端点可帮助您可视化模板化方式 客户数据字段 在目标配置中定义的内容如下所示。

端点会为您的客户数据字段生成随机值，并在响应中返回它们。 这有助于您验证客户数据字段的语义结构，如存储段名称或文件夹路径。

快速入门

在继续之前，请查看 入门指南 有关成功调用API所需的重要信息，包括如何获取所需的目标创作权限和所需标头。

先决条件

在使用 /template/render 端点，确保满足以下条件：

• 您已通过Destination SDK创建了一个基于文件的现有目标，您可以在 目标目录.

• 要成功发出API请求，您需要与要测试的目标实例对应的目标实例ID。 在Platform UI中浏览与目标的连接时，从URL获取应在API调用中使用的目标实例ID。

  

呈现模板化的客户字段

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错误处理

Destination SDKAPI端点遵循常规Experience PlatformAPI错误消息原则。 请参阅 API状态代码 和 请求标头错误 平台疑难解答指南中。

后续步骤

阅读本文档后，您现在知道如何验证在 目标服务器.

Business.Adobe.com 资源