Extremo de consentimiento

Ciertas regulaciones requieren el consentimiento explícito del cliente antes de que se puedan recopilar sus datos personales. El extremo /consent de la API Privacy Service le permite procesar las solicitudes de consentimiento de los clientes e integrarlas en el flujo de trabajo de privacidad.

Antes de usar esta guía, consulte la guía de introducción para obtener información sobre los encabezados de autenticación requeridos que se presentan en el ejemplo de llamada de API a continuación.

Procesamiento de una solicitud de consentimiento de cliente

Las solicitudes de consentimiento se procesan realizando una solicitud de POST al extremo /consent.

Formato de API

POST /consent

Solicitud

La siguiente solicitud crea un nuevo trabajo de consentimiento para los identificadores de usuario proporcionados en la matriz entities.

curl -X POST \
  https://platform.adobe.io/data/core/privacy/consent \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
        "optOutOfSale": true,
        "entities": [
          {
            "nameSpace": "email",
            "values": [
              "dsmith@acme.com",
              "ajones@acme.com"
            ]
          },
          {
            "nameSpace": "ECID",
            "values": [
              "443636576799758681021090721276"
            ]
          }
        ]
      }'
Propiedad
Descripción
optOutOfSale
Cuando se establece en true, indica que los usuarios proporcionados en entities desean excluirse de la venta o el uso compartido de sus datos personales.
entities
Matriz de objetos que indica los usuarios a los que se aplica la solicitud de consentimiento. Cada objeto contiene namespace y una matriz de values para hacer coincidir a los usuarios individuales con ese área de nombres.
nameSpace
Cada objeto de la matriz entities debe contener una de las áreas de nombres de identidad estándar reconocidas por la API de Privacy Service.
values
Una matriz de valores para cada usuario, correspondiente al nameSpace proporcionado.
NOTE
Para obtener más información sobre cómo determinar qué valores de identidad de cliente se enviarán a Privacy Service, consulte la guía de proporcionar datos de identidad.

Respuesta

Una respuesta correcta devuelve el estado HTTP 202 (Aceptado) sin carga útil, lo que indica que Privacy Service aceptó la solicitud y que se está procesando.

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580