Recuperar una configuración de servidor de destino
Esta página ejemplifica la solicitud de API y la carga útil que puede utilizar para recuperar información sobre una configuración de servidor de destino existente utilizando /authoring/destination-servers
Extremo de API.
Para obtener una descripción detallada de las funciones utilizadas por los servidores de destino, lea los siguientes artículos:
Introducción a las operaciones de API del servidor de destino get-started
Antes de continuar, consulte la guía de introducción para obtener información importante que necesita conocer para realizar llamadas correctamente a la API, incluido cómo obtener el permiso de creación de destino requerido y los encabezados necesarios.
Recuperar una configuración de servidor de destino retrieve
Puede recuperar una configuración de servidor de destino existente realizando una GET
solicitud a la /authoring/destination-servers
punto final.
platform.adobe.io/data/core/activation/authoring/destination-servers
Formato de API
Utilice el siguiente formato de API para recuperar todas las configuraciones del servidor de destino para su cuenta.
GET /authoring/destination-servers
Utilice el siguiente formato de API para recuperar una configuración específica del servidor de destino, definida por la variable {INSTANCE_ID}
parámetro.
GET /authoring/destination-servers/{INSTANCE_ID}
Las dos solicitudes siguientes recuperan todas las configuraciones del servidor de destino para su organización IMS o una configuración específica del servidor de destino, en función de si pasa la variable INSTANCE_ID
en la solicitud.
Seleccione cada pestaña a continuación para ver la carga útil correspondiente y sus respuestas.
La siguiente solicitud recupera la lista de configuraciones del servidor de destino a las que tiene acceso, según IMS Org ID y la configuración de zona protegida.
accordion | ||
---|---|---|
Solicitud | ||
|
accordion | ||
---|---|---|
Respuesta | ||
Una respuesta correcta devuelve el estado HTTP 200 con una lista de configuraciones de servidor de destino a las que tiene acceso, en función de IMS Org ID y el nombre de la zona protegida que ha utilizado. Uno
|
La siguiente solicitud recupera una configuración específica del servidor de destino definida por el {INSTANCE_ID}
parámetro.
accordion | ||||||||
---|---|---|---|---|---|---|---|---|
Solicitud | ||||||||
|
accordion | ||
---|---|---|
Respuesta | ||
Una respuesta correcta devuelve el estado HTTP 200 con la configuración del servidor de destino correspondiente a
|
Administración de errores de API error-handling
Los extremos de la API de Destination SDK siguen los principios generales del mensaje de error de la API de Experience Platform. Consulte Códigos de estado de API y errores de encabezado de solicitud en la guía de solución de problemas de Platform.
Pasos siguientes next-steps
Después de leer este documento, ahora sabe cómo recuperar una configuración de servidor de destino a través del Destination SDK /authoring/destination-servers
Extremo de API.
Para obtener más información acerca de lo que puede hacer con este extremo, consulte los siguientes artículos: