Constante eindpunt

Bepaalde voorschriften vereisen uitdrukkelijke toestemming van de klant voordat de persoonsgegevens kunnen worden verzameld. Met het /consent -eindpunt in de Privacy Service API kunt u verzoeken om toestemming van klanten verwerken en deze integreren in uw privacyworkflow.

Alvorens deze gids te gebruiken, gelieve te verwijzen naar begonnengids voor informatie over de vereiste authentificatiekopballen die in de voorbeeld API hieronder vraag worden voorgesteld.

Een verzoek om toestemming van een klant verwerken

Verzoeken om toestemming worden verwerkt door een POST aan te vragen bij het /consent eindpunt.

API formaat

POST /consent

Verzoek

Met de volgende aanvraag wordt een nieuwe toestemmingstaak gemaakt voor de gebruikers-id's die in de array entities worden opgegeven.

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"
            ]
          }
        ]
      }'
Eigenschap
Beschrijving
optOutOfSale
Wanneer deze waarde is ingesteld op true, geven de gebruikers die onder entities worden aangeboden, aan dat ze de verkoop of het delen van hun persoonlijke gegevens willen weigeren.
entities
Een array met objecten die aangeven op welke gebruikers de aanvraag voor toestemming van toepassing is. Elk object bevat een namespace en een array van values die overeenkomen met afzonderlijke gebruikers met die naamruimte.
nameSpace
Elk voorwerp in de entities serie moet één van standaard identiteitsnamespacesbevatten die door Privacy Service API wordt erkend.
values
Een array van waarden voor elke gebruiker, die overeenkomt met de opgegeven nameSpace .
NOTE
Voor meer informatie over hoe te om te bepalen welke waarden van de klantenidentiteit om naar Privacy Service te verzenden, zie de gids over het verstrekken van identiteitsgegevens.

Reactie

Een geslaagde reactie retourneert HTTP-status 202 (geaccepteerd) zonder payload om aan te geven dat de aanvraag is geaccepteerd door Privacy Service en wordt verwerkt.

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