DocumentaçãoExperience PlatformGuia do Serviço de privacidade

Endpoint de consentimento

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor

Certos regulamentos exigem o consentimento explícito do cliente antes que seus dados pessoais possam ser coletados. O ponto de extremidade /consent na API Privacy Service permite processar solicitações de consentimento do cliente e integrá-las ao seu fluxo de trabalho de privacidade.

Antes de usar este guia, consulte o guia de introdução para obter informações sobre os cabeçalhos de autenticação necessários apresentados na chamada de API de exemplo abaixo.

Processar uma solicitação de consentimento do cliente

As solicitações de consentimento são processadas fazendo uma solicitação POST para o ponto de extremidade /consent.

Formato da API

POST /consent

Solicitação

A solicitação a seguir cria um novo trabalho de consentimento para as IDs de usuário fornecidas na 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"
            ]
          }
        ]
      }'
Propriedade
Descrição
optOutOfSale
Quando definido como verdadeiro, indica que os usuários fornecidos em entities desejam recusar a venda ou o compartilhamento de seus dados pessoais.
entities
Uma matriz de objetos que indica os usuários aos quais a solicitação de consentimento se aplica. Cada objeto contém um namespace e uma matriz de values para corresponder usuários individuais a esse namespace.
nameSpace
Cada objeto na matriz entities deve conter um dos namespaces de identidade padrão reconhecidos pela API Privacy Service.
values
Uma matriz de valores para cada usuário, correspondente ao nameSpace fornecido.
NOTE
Para obter mais informações sobre como determinar quais valores de identidade do cliente enviar para Privacy Service, consulte o manual em fornecendo dados de identidade.

Resposta

Uma resposta bem-sucedida retorna o status HTTP 202 (Aceito) sem carga, indicando que a solicitação foi aceita por Privacy Service e está em processamento.

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