Punto de conexión de API: https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/
En esta página se enumeran y describen todas las operaciones de API que puede realizar mediante la /authoring/testing/destinationInstance/
punto final de la API, para comprobar si el destino está configurado correctamente y verificar la integridad de los flujos de datos en el destino configurado. Para obtener una descripción de la funcionalidad admitida por este extremo, lea Probar la configuración de destino.
Se realizan solicitudes al extremo de prueba con o sin añadir perfiles a la llamada. Si no envía ningún perfil en la solicitud, Adobe los generará internamente y los agregará a la solicitud.
Puede usar la variable API de generación de perfiles de muestra para crear perfiles para utilizarlos en solicitudes a la API de prueba de destino.
Antes de continuar, revise la guía de introducción para obtener información importante que debe conocer para realizar llamadas correctamente a la API de , incluido cómo obtener el permiso de creación de destino requerido y los encabezados necesarios.
Puede probar la configuración de destino realizando una solicitud de POST al authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
y proporcionando el ID de instancia de destino del destino que está probando.
Formato de API
POST authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
Parámetro de consulta | Descripción |
---|---|
{DESTINATION_INSTANCE_ID} |
El ID de instancia de destino del destino que está probando. |
Solicitud
La siguiente solicitud llama al extremo de la API de REST de su destino. La solicitud la configura el {DESTINATION_INSTANCE_ID}
parámetro de consulta.
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}' \
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 junto con la respuesta de API del extremo de la API REST de su destino.
{
"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"
}
}
}
]
}
Propiedad | Descripción |
---|---|
aggregationKey |
Incluye información sobre la directiva de agregación configurada para el destino. Para obtener más información, lea la Política de agregación en el documento de configuración de destino. |
traceId |
Identificador único de la operación. Cuando encuentre errores, puede compartir este ID con el equipo de Adobe para solucionar problemas. |
results.httpCalls.request |
Incluye la solicitud que se envió por Adobe al destino. |
results.httpCalls.response |
Incluye la respuesta recibida por Adobe desde el destino. |
inputProfiles |
Incluye los perfiles que se exportaron en la llamada al destino. Los perfiles coinciden con el esquema de origen. |
Puede probar la configuración de destino realizando una solicitud de POST al authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
y proporcionando el ID de instancia de destino del destino que está probando.
Formato de API
POST authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}
Parámetro de consulta | Descripción |
---|---|
{DESTINATION_INSTANCE_ID} |
El ID de instancia de destino del destino que está probando. |
Solicitud
La siguiente solicitud llama al extremo de la API de REST de su destino. La solicitud se configura con los parámetros proporcionados en la carga útil y en la variable {DESTINATION_INSTANCE_ID}
parámetro de consulta.
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"
}
}
}
]
}'
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 junto con la respuesta de API del extremo de la API REST de su destino.
{
"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"
}
}
}
]
}
Los extremos de la API del Destination SDK siguen los principios generales del mensaje de error de la API del Experience Platform. Consulte Códigos de estado de API y errores en el encabezado de la solicitud en la guía de solución de problemas de Platform.
Después de leer este documento, ahora sabe cómo probar el destino. Ahora puede utilizar el Adobe proceso de documentación de autoservicio para crear una página de documentación para el destino.