使用範例設定檔測試您的串流目的地 template-api-operations
IMPORTANT
API端點：
https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/此頁面列出並描述您可以使用/authoring/testing/destinationInstance/ API端點執行的所有API作業，以測試您的目的地是否正確設定，以及驗證資料流至您設定之目的地的完整性。 如需此端點支援功能的說明，請閱讀測試您的目的地組態。
您向測試端點提出請求，無論是否將設定檔新增至呼叫。 如果您未在請求上傳送任何設定檔，Adobe會在內部為您產生這些設定檔，並將其新增至請求中。
您可以使用範例設定檔產生API來建立設定檔，以用於目的地測試API的要求。
如何取得目的地執行個體ID get-destination-instance-id
IMPORTANT
- 若要使用此API，您在Experience PlatformUI中必須有與目的地的現有連線。 閱讀連線到目的地以及啟用設定檔和對象到目的地以取得詳細資訊。
- 建立與目的地的連線後，在瀏覽與目的地的連線時，取得您應該用於此端點之API呼叫中的目的地執行個體識別碼。
開始使用目的地測試API操作 get-started
繼續之前，請檢閱快速入門手冊以取得重要資訊，您必須瞭解這些資訊才能成功呼叫API，包括如何取得必要的目的地撰寫許可權和必要的標頭。
測試您的目的地設定，而不將設定檔新增至呼叫 test-without-adding-profiles
您可以透過向authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}端點發出POST請求並提供您正在測試的目的地的目的地執行個體識別碼，來測試您的目的地設定。
API格式
POST authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
查詢引數
說明
{DESTINATION_INSTANCE_ID}您正在測試之目的地的目的地執行個體ID。
要求
以下請求會呼叫您目的地的REST API端點。 要求是由{DESTINATION_INSTANCE_ID}查詢引數所設定。
curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/49966037-32cd-4457-a105-2cbf9c01826a' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
回應
成功的回應會傳回HTTP狀態200以及您目的地REST API端點的API回應。
{
"results":[
{
"aggregationKey":{
"destinationInstanceId":"string",
"segmentId":"string",
"segmentStatus":"realized",
"identityNamespaces":[
[
"email",
"phone"
]
]
},
"httpCalls":[
{
"traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
"request":{
"body":"{ \"attributes\": [ { \"external_id\": \"external_id-h29Fq\" , \"AdobeExperiencePlatformSegments\": { \"add\": [ \"Nirvana fans\" , \"RHCP fans\" ], \"remove\": [ ] } , \"key\": \"string\" } ] }",
"headers":[
{
"Content-Type":"application/json"
}
],
"method":"POST",
"uri":"https://api.moviestar.com/users/track"
},
"response":{
"body":"{\"status\": \"success\"}",
"code":"200",
"headers":[
{
"Connection":"keep-alive"
},
{
"Content-Type":"application/json"
},
{
"Server":"nginx"
},
{
"Vary":"Origin,Accept-Encoding"
},
{
"transfer-encoding":"chunked"
}
]
}
}
]
}
],
"inputProfiles":[
{
"segmentMembership":{
"ups":{
"03fb9938-8537-4b4c-87f9-9c4d413a0ee5":{
"lastQualificationTime":"2021-06-17T12:25:12.872039Z",
"status":"realized"
},
"27e05542-d6a3-46c7-9c8e-d59d50229530":{
"lastQualificationTime":"2021-06-17T12:25:12.872042Z",
"status":"realized"
}
}
},
"personalEmail":{
"address":"john.smith@abc.com"
},
"identityMap":{
"ECID":[
{
"id":"ECID-vlnt6"
}
]
},
"person":{
"name":{
"firstName":"string"
}
}
}
]
}
屬性
說明
aggregationKey包含針對目的地設定的彙總原則相關資訊。 如需詳細資訊，請閱讀彙總原則檔案。
traceId作業的唯一識別碼。 發生錯誤時，您可以與Adobe團隊共用此ID，以進行疑難排解。
results.httpCalls.request包含Adobe傳送至您的目的地的要求。
results.httpCalls.response包含Adobe從目的地收到的回應。
inputProfiles包含在呼叫目的地時匯出的設定檔。 設定檔符合您的來源結構描述。
使用新增至呼叫的設定檔測試您的目的地設定 test-with-added-profiles
您可以透過向authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}端點發出POST請求並提供您正在測試的目的地的目的地執行個體識別碼，來測試您的目的地設定。
API格式
POST authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
查詢引數
說明
{DESTINATION_INSTANCE_ID}您正在測試之目的地的目的地執行個體ID。
要求
以下請求會呼叫您目的地的REST API端點。 要求是由承載中提供的引數和{DESTINATION_INSTANCE_ID}查詢引數所設定。
curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/49966037-32cd-4457-a105-2cbf9c01826a' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw '{
"profiles":[
{
"segmentMembership":{
"ups":{
"374a9a6c-c719-4cdb-a660-155a2838e6d6":{
"lastQualificationTime":"2021-05-13T12:16:27.248585Z",
"status":"realized"
},
"896f8776-9498-47b4-b994-51cb3f61c2c5":{
"lastQualificationTime":"2021-05-13T12:16:27.248605Z",
"status":"realized"
}
}
},
"identityMap":{
"ECID":[
{
"id":"ECID-Z3i2t"
}
],
"external_id":[
{
"id":"external_id-h29Fq"
}
]
},
"attributes":{
"firstName":{
"value":"John"
}
}
}
]
}'
回應
成功的回應會傳回HTTP狀態200以及您目的地REST API端點的API回應。
{
"results":[
{
"aggregationKey":{
"destinationInstanceId":"string",
"segmentId":"string",
"segmentStatus":"realized",
"identityNamespaces":[
[
"email",
"phone"
]
]
},
"httpCalls":[
{
"traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
"request":{
"body":"{ \"attributes\": [ { \"external_id\": \"external_id-h29Fq\" , \"AdobeExperiencePlatformSegments\": { \"add\": [ \"Nirvana fans\" , \"RHCP fans\" ], \"remove\": [ ] } , \"key\": \"string\" } ] }",
"headers":[
{
"Content-Type":"application/json"
}
],
"method":"POST",
"uri":"https://api.moviestar.com/users/track"
},
"response":{
"body":"{\"status\": \"success\"}",
"code":"200",
"headers":[
{
"Connection":"keep-alive"
},
{
"Content-Type":"application/json"
},
{
"Server":"nginx"
},
{
"Vary":"Origin,Accept-Encoding"
},
{
"transfer-encoding":"chunked"
}
]
}
}
]
}
],
"inputProfiles":[
{
"segmentMembership":{
"ups":{
"374a9a6c-c719-4cdb-a660-155a2838e6d6":{
"lastQualificationTime":"2021-05-13T12:16:27.248585Z",
"status":"realized"
},
"896f8776-9498-47b4-b994-51cb3f61c2c5":{
"lastQualificationTime":"2021-05-13T12:16:27.248605Z",
"status":"realized"
}
}
},
"identityMap":{
"ECID":[
{
"id":"ECID-Z3i2t"
}
],
"external_id":[
{
"id":"external_id-h29Fq"
}
]
},
"attributes":{
"firstName":{
"value":"John"
}
}
}
]
}
API錯誤處理 api-error-handling
Destination SDK API端點遵循一般Experience Platform API錯誤訊息原則。 請參閱Platform疑難排解指南中的API狀態碼和請求標頭錯誤。
後續步驟
閱讀本檔案後，您現在知道如何測試您的目的地。 您現在可以使用Adobe自助式檔案程式，為您的目的地建立檔案頁面。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6