Operaciones de API de extremo de credenciales

IMPORTANTE

Punto final de API: platform.adobe.io/data/core/activation/authoring/credentials

Esta página enumera y describe todas las operaciones de API que puede realizar con el extremo de API /authoring/credentials .

Cuándo utilizar el extremo de la API /credentials

IMPORTANTE

En la mayoría de los casos, no necesita utilizar el extremo de la API /credentials. En su lugar, puede configurar la información de autenticación para el destino mediante los parámetros customerAuthenticationConfigurations del extremo /destinations . Lea Credentials configuration para obtener más información.

Utilice este extremo de API y seleccione PLATFORM_AUTHENTICATION en la configuración de destino si hay un sistema de autenticación global entre el Adobe y el destino y el cliente Platform no necesita proporcionar ninguna credencial de autenticación para conectarse al destino. En este caso, debe crear un objeto credentials utilizando el extremo API /credentials .

Introducción a las operaciones de API de configuración de credenciales

Antes de continuar, consulte 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 necesario y los encabezados necesarios.

Crear una configuración de credenciales

Puede crear una nueva configuración de credenciales realizando una solicitud de POST al extremo /authoring/credentials .

Formato de API

POST /authoring/credentials

Solicitud

La siguiente solicitud crea una nueva configuración de credenciales, configurada por los parámetros proporcionados en la carga útil. La carga útil siguiente incluye todos los parámetros aceptados por el extremo /authoring/credentials . Tenga en cuenta que no es necesario agregar todos los parámetros en la llamada de y que la plantilla se puede personalizar, según los requisitos de la API.

curl -X POST https://platform.adobe.io/data/core/activation/authoring/credentials \
 -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 '
{
   "oauth2UserAuthentication":{
      "url":"string",
      "clientId":"string",
      "clientSecret":"string",
      "username":"string",
      "password":"string",
      "header":"string"
   },
   "oauth2ClientAuthentication":{
      "url":"string",
      "clientId":"string",
      "clientSecret":"string",
      "header":"string",
      "developerToken":"string"
   },
   "oauth2AccessTokenAuthentication":{
      "accessToken":"string",
      "expiration":"string",
      "username":"string",
      "userId":"string",
      "url":"string",
      "header":"string"
   },
   "oauth2RefreshTokenAuthentication":{
      "refreshToken":"string",
      "expiration":"string",
      "clientId":"string",
      "clientSecret":"string",
      "url":"string",
      "header":"string"
   }
}
Parámetro Tipo Descripción
username Cadena nombre de usuario de inicio de sesión de configuración de credenciales
password Cadena contraseña de inicio de sesión de configuración de credenciales
url Cadena URL del proveedor de autorización
clientId Cadena ID de cliente de credenciales de cliente/aplicación
clientSecret Cadena Secreto de cliente de las credenciales de cliente/aplicación
accessToken Cadena Token de acceso proporcionado por el proveedor de autorización
expiration Cadena El tiempo de vida del token de acceso
refreshToken Cadena Actualizar token proporcionado por el proveedor de autorización
header Cadena Cualquier encabezado necesario para la autorización

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con detalles de la configuración de credenciales recién creada.

Enumerar configuraciones de credenciales

Puede recuperar una lista de todas las configuraciones de credenciales para su organización IMS realizando una solicitud de GET al extremo /authoring/credentials .

Formato de API

GET /authoring/credentials

Solicitud

La siguiente solicitud recuperará la lista de configuraciones de credenciales a las que tiene acceso, según la configuración de la organización y el entorno limitado de IMS.

curl -X GET https://platform.adobe.io/data/core/activation/authoring/credentials \
 -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 configuraciones de credenciales a las que tiene acceso, según el ID de organización de IMS y el nombre del simulador para pruebas que utilizó. Un instanceId corresponde a la plantilla para una configuración de credenciales. La respuesta se trunca para su brevedad.

{
   "items":[
      {
         "instanceId":"n55affa0-3747-4030-895d-1d1236bb3680",
         "createdDate":"2021-06-07T06:41:48.641943Z",
         "lastModifiedDate":"2021-06-07T06:41:48.641943Z",
         "type":"OAUTH2_USER_CREDENTIAL",
         "name":"yourdestination",
         "oauth2UserAuthentication":{
            "url":"ABCD",
            "clientId":"ABCDEFGHIJKL",
            "clientSecret":"clientsecret",
            "username":"username",
            "password":"password",
            "header":"header"
         }
      }
   ]
}
    

Actualizar una configuración de credenciales existente

Puede actualizar una configuración de credenciales existente realizando una solicitud de PUT al extremo /authoring/credentials y proporcionando el ID de instancia de la configuración de credenciales que desea actualizar. En el cuerpo de la llamada, proporcione la configuración de credenciales actualizada.

Formato de API

PUT /authoring/credentials/{INSTANCE_ID}
Parámetro Descripción
{INSTANCE_ID} El ID de la configuración de credenciales que desea actualizar.

Solicitud

La siguiente solicitud actualiza una configuración de credenciales existente, configurada por los parámetros proporcionados en la carga útil.

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/credentials/n55affa0-3747-4030-895d-1d1236bb3680 \
 -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}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "instanceId":"n55affa0-3747-4030-895d-1d1236bb3680",
   "createdDate":"2021-06-07T06:41:48.641943Z",
   "lastModifiedDate":"2021-06-07T06:41:48.641943Z",
   "type":"OAUTH2_USER_CREDENTIAL",
   "name":"yourdestination",
   "oauth2UserAuthentication":{
      "url":"ABCD",
      "clientId":"ABCDEFGHIJKL",
      "clientSecret":"clientsecret",
      "username":"username",
      "password":"password",
      "header":"header"
   }
}

Recuperar una configuración de credenciales específica

Puede recuperar información detallada sobre una configuración de credenciales específica realizando una solicitud de GET al extremo /authoring/credentials y proporcionando el ID de instancia de la configuración de credenciales que desea actualizar.

Formato de API

GET /authoring/credentials/{INSTANCE_ID}
Parámetro Descripción
{INSTANCE_ID} El ID de la configuración de credenciales que desea recuperar.

Solicitud

curl -X GET https://platform.adobe.io/data/core/activation/authoring/credentials/n55affa0-3747-4030-895d-1d1236bb3680 \
 -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 configuración de credenciales especificada.

{
   "instanceId":"n55affa0-3747-4030-895d-1d1236bb3680",
   "createdDate":"2021-06-07T06:41:48.641943Z",
   "lastModifiedDate":"2021-06-07T06:41:48.641943Z",
   "type":"OAUTH2_USER_CREDENTIAL",
   "name":"yourdestination",
   "oauth2UserAuthentication":{
      "url":"ABCD",
      "clientId":"ABCDEFGHIJKL",
      "clientSecret":"clientsecret",
      "username":"username",
      "password":"password",
      "header":"header"
   }
}

Eliminar una configuración de credenciales específica

Puede eliminar la configuración de credenciales especificada realizando una solicitud de DELETE al extremo /authoring/credentials y proporcionando el ID de la configuración de credenciales que desea eliminar en la ruta de solicitud.

Formato de API

DELETE /authoring/credentials/{INSTANCE_ID}
Parámetro Descripción
{INSTANCE_ID} El id de la configuración de credenciales que desea eliminar.

Solicitud

curl -X DELETE https://platform.adobe.io/data/core/activation/authoring/credentials/n55affa0-3747-4030-895d-1d1236bb3680 \
 -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 junto con una respuesta HTTP vacía.

Gestión de errores de API

Los extremos de la API del SDK de destino siguen los principios generales del mensaje de error de la API del Experience Platform. Consulte los 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

Después de leer este documento, ahora sabe cuándo usar el extremo de credenciales y cómo configurar una configuración de credenciales utilizando el extremo de API /authoring/credentials o el extremo /authoring/destinations. Lea cómo utilizar el SDK de destino para configurar su destino para comprender dónde encaja este paso en el proceso de configuración de su destino.

En esta página