Ciertas regulaciones requieren el consentimiento explícito del cliente antes de que se puedan recopilar sus datos personales. El /consent
punto final de la Privacy Service API le permite procesar solicitudes de consentimiento del cliente e integrarlas en su flujo de trabajo de privacidad.
Antes de utilizar esta guía, consulte la sección Introducción para obtener información sobre los encabezados de autenticación requeridos que se presentan en la llamada de API de ejemplo siguiente.
Las solicitudes de consentimiento se procesan realizando una solicitud de POST al /consent
extremo.
Formato API
POST /consent
Solicitud
La siguiente solicitud crea un nuevo trabajo de consentimiento para los ID de usuario proporcionados en la entities
matriz.
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: {IMS_ORG}' \
-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 incluidos en entities desean excluirse de la venta o el uso compartido de sus datos personales. |
entities |
Matriz de objetos que indica a los usuarios a los que se aplica la solicitud de consentimiento. Cada objeto contiene una namespace y una matriz de values para que los usuarios individuales coincidan con esa Área de nombres. |
nameSpace |
Cada objeto de la entities matriz debe contener una de las Áreas de nombres de identidad estándar reconocidas por la API de Privacy Service. |
values |
Matriz de valores para cada usuario, correspondiente con el valor proporcionado nameSpace . |
Para obtener más información sobre cómo determinar a qué valores de identidad del cliente se enviarán Privacy Service, consulte la guía para proporcionar datosde identidad.
Respuesta
Una respuesta correcta devuelve el estado HTTP 202 (Aceptado) sin carga útil, lo que indica que la solicitud ha sido aceptada por Privacy Service y se está procesando.