DokumentationExperience PlatformAnvändarhandbok om Privacy Service

Slutpunkt för samtycke

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

Vissa bestämmelser kräver uttryckligt samtycke från kunden innan deras personuppgifter kan samlas in. Med slutpunkten /consent i API:t Privacy Service kan du bearbeta förfrågningar om kundsamtycke och integrera dem i ditt sekretessarbetsflöde.

Innan du använder den här guiden bör du läsa guiden Komma igång för att få information om de autentiseringshuvuden som visas i exemplet på API-anrop nedan.

Bearbeta en begäran om kundgodkännande

Godkännandebegäranden bearbetas genom att en POST begärs till slutpunkten /consent.

API-format

POST /consent

Begäran

Följande begäran skapar ett nytt medgivandejobb för de användar-ID som anges i entities-arrayen.

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"
            ]
          }
        ]
      }'
Egenskap
Beskrivning
optOutOfSale
Om värdet är true anger det att de användare som anges under entities vill avanmäla sig från försäljning eller delning av sina personuppgifter.
entities
En array med objekt som anger vilka användare som medgivandebegäran gäller för. Varje objekt innehåller en namespace och en array med values som matchar enskilda användare med det namnutrymmet.
nameSpace
Varje objekt i arrayen entities måste innehålla ett av de standardnamnutrymmen för identiteter som känns igen av Privacy Services-API:t.
values
En array med värden för varje användare, som motsvarar angiven nameSpace.
NOTE
Mer information om hur du avgör vilka värden för kundidentitet som ska skickas till Privacy Service finns i handboken Tillhandahålla identitetsdata.

Svar

Ett lyckat svar returnerar HTTP-status 202 (Accepterad) utan nyttolast, vilket anger att begäran accepterades av Privacy Service och håller på att bearbetas.

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