驗證範本化客戶欄位
總覽 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
閱讀本檔案後，您現在瞭解如何驗證中定義的客戶資料欄位設定 目的地伺服器.