Operaciones de API de extremo de Destinos de publicación

IMPORTANTE

Punto de conexión de API: platform.adobe.io/data/core/activation/authoring/destinations/publish

En esta página se enumeran y describen todas las operaciones de API que puede realizar mediante la /authoring/destinations/publish extremo de API.

Después de configurar y probar el destino, puede enviarlo a Adobe para su revisión y publicación.

Utilice el extremo de la API de destinos de publicación para enviar una solicitud de publicación cuando:

  • Como socio Destination SDK, desea que el destino productivo esté disponible en todas las organizaciones de Experience Platform para que lo utilicen todos los clientes Experience Platform;
  • Desea que el destino personalizado esté disponible en su propia organización de Experience Platform, en todos los entornos limitados.

Introducción a las operaciones de API de publicación 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.

Enviar una configuración de destino para su publicación

Puede enviar una configuración de destino para su publicación realizando una solicitud de POST al /authoring/destinations/publish punto final.

Formato de API

POST /authoring/destinations/publish

Solicitud

La siguiente solicitud envía un destino para su publicación en todas las organizaciones configuradas por los parámetros proporcionados en la carga útil. La carga útil siguiente incluye todos los parámetros aceptados por la variable /authoring/destinations/publish punto final.

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destinations/publish \
 -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":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "destinationAccess":"LIMITED",
   "allowedOrgs":[
      "xyz@AdobeOrg",
      "lmn@AdobeOrg"
   ]
}
Parámetro Tipo Descripción
destinationId Cadena El ID de destino de la configuración de destino que envía para su publicación. Obtenga el ID de destino de una configuración de destino utilizando la variable referencia de la API de configuración de destino.
destinationAccess Cadena ALL o LIMITED. Especifique si desea que el destino aparezca en el catálogo para todos los clientes Experience Platform o solo para determinadas organizaciones.
Nota: Si usa LIMITED, el destino solo se publicará para su organización Experience Platform. Si desea publicar el destino en un subconjunto de organizaciones de Experience Platform con fines de prueba de clientes, póngase en contacto con el servicio de asistencia técnica de Adobe.
allowedOrgs Cadena Si usa "destinationAccess":"LIMITED", especifique las organizaciones de Experience Platform para las que estará disponible el destino.

Respuesta

Una respuesta correcta devuelve el estado HTTP 201 con detalles de la solicitud de publicación de destino.

Enumerar solicitudes de publicación de destino

Puede recuperar una lista de todos los destinos enviados para su publicación en la organización IMS realizando una solicitud de GET al /authoring/destinations/publish punto final.

Formato de API

GET /authoring/destinations/publish

Solicitud

La siguiente solicitud recuperará la lista de destinos enviados para publicación a la que tiene acceso, según la configuración de la organización y el simulador de pruebas de IMS.

curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/publish \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

La siguiente respuesta devuelve el estado HTTP 200 con una lista de destinos enviados para publicación a la que tiene acceso, según el ID de organización de IMS y el nombre del simulador de pruebas que ha utilizado. One configId corresponde a la solicitud de publicación de un destino.

{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"string",
         "allowedOrgs":[
            "xyz@AdobeOrg",
            "lmn@AdobeOrg"
         ],
         "status":"TEST",
         "publishedDate":"1630617746"
      }
   ]
}
    
Parámetro Tipo Descripción
destinationId Cadena El ID de destino de la configuración de destino que ha enviado para su publicación.
publishDetailsList.configId Cadena El ID exclusivo de la solicitud de publicación de destino para el destino enviado.
publishDetailsList.allowedOrgs Cadena Devuelve las organizaciones de Experience Platform para las que debe estar disponible el destino.
publishDetailsList.status Cadena El estado de la solicitud de publicación de destino. Los valores posibles son TEST, REVIEW, APPROVED, PUBLISHED, DENIED, REVOKED, DEPRECATED.
publishDetailsList.publishedDate Cadena La fecha en la que se envió el destino para su publicación, en tiempo de época.

Actualizar una solicitud de publicación de destino existente

Puede actualizar las organizaciones permitidas en una solicitud de publicación de destino existente realizando una solicitud de PUT al /authoring/destinations/publish y proporcione el ID del destino para el que desea actualizar las organizaciones permitidas. En el cuerpo de la llamada, proporcione las organizaciones permitidas actualizadas.

Formato de API

PUT /authoring/destinations/publish/{DESTINATION_ID}
Parámetro Descripción
{DESTINATION_ID} El ID del destino para el que desea actualizar la solicitud de publicación.

Solicitud

La siguiente solicitud actualiza una solicitud de publicación de destino existente, configurada por los parámetros proporcionados en la carga útil. En la llamada de ejemplo siguiente, actualizamos las organizaciones permitidas.

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/destinations/publish/1230e5e4-4ab8-4655-ae1e-a6296b30f2ec \
 -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":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "destinationAccess":"LIMITED",
   "allowedOrgs":[
      "abc@AdobeOrg",
      "def@AdobeOrg"
   ]
}

Obtener el estado de una solicitud de publicación de destino específica

Puede recuperar información detallada sobre una solicitud de publicación de destino específica realizando una solicitud de GET al /authoring/destinations/publish y proporcionando el ID del destino para el que desea recuperar el estado de publicación.

Formato de API

GET /authoring/destinations/publish/{DESTINATION_ID}
Parámetro Descripción
{DESTINATION_ID} El ID del destino para el que desea recuperar el estado de publicación.

Solicitud

curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/publish/1230e5e4-4ab8-4655-ae1e-a6296b30f2ec \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con información detallada sobre la solicitud de publicación de destino especificada.

{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"string",
         "allowedOrgs":[
            "xyz@AdobeOrg",
            "lmn@AdobeOrg"
         ],
         "status":"TEST",
         "publishedDate":"string"
      }
   ]
}

Gestión de errores de API

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.

Pasos siguientes

Después de leer este documento, ahora sabe cómo enviar una solicitud de publicación para su destino. El equipo de Adobe Experience Platform revisará su solicitud de publicación y le responderá con cinco días hábiles.

En esta página