Eliminar una configuración de credenciales

Última actualización: 2023-10-31
  • Creado para:
  • Developer
    User
    Admin
    Leader
IMPORTANTE

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

Esta página ejemplifica la solicitud de API y la carga útil que puede utilizar para eliminar una configuración de credenciales mediante /authoring/credentials Extremo de API.

Cuándo usar el /credentials Extremo de API

IMPORTANTE

En la mayoría de los casos, no necesita usar el /credentials Extremo de API. En su lugar, puede configurar la información de autenticación para su destino mediante el customerAuthenticationConfigurations parámetros del /destinations punto final.

Leer Configuración de autenticación del cliente para obtener información detallada sobre los tipos de autenticación admitidos.

Utilice este extremo de API para crear una configuración de credenciales solo si hay un sistema de autenticación global entre el Adobe y la plataforma de destino, y la variable Platform el cliente no necesita proporcionar credenciales de autenticación para conectarse a su destino. En este caso, debe crear una configuración de credenciales de utilizando /credentials Extremo de API.

Al utilizar un sistema de autenticación global, debe establecer "authenticationRule":"PLATFORM_AUTHENTICATION" en el envío de destino configuración, cuando creación de una nueva configuración de destino.

IMPORTANTE

Todos los nombres y valores de parámetro admitidos por el Destination SDK son distingue mayúsculas de minúsculas. Para evitar errores de distinción entre mayúsculas y minúsculas, utilice los nombres y valores de los parámetros exactamente como se muestra en la documentación.

Introducción a las operaciones de API de credenciales

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.

Eliminar una configuración de credenciales

Puede eliminar un existente configuración de credenciales realizando una DELETE solicitud a la /authoring/credentials punto final con {INSTANCE_ID}de la configuración de credenciales que desea eliminar.

Para obtener una configuración de destino existente y su correspondiente {INSTANCE_ID}, consulte el artículo sobre recuperar una configuración de credenciales.

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.

La siguiente solicitud elimina una configuración de credenciales definida por el {INSTANCE_ID} parámetro.

 Solicitud
curl -X DELETE https://platform.adobe.io/data/core/activation/authoring/credentials/{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -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.

Administración de errores de API

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

Después de leer este documento, ahora sabe cómo eliminar una configuración de credenciales mediante la variable /authoring/credentials Extremo de API. Leer cómo utilizar Destination SDK para configurar el destino para comprender dónde encaja este paso en el proceso de configuración del destino.

En esta página