DocumentazioneExperience PlatformGuida di Privacy Service

Endpoint di consenso

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

Creato per:

  • Sviluppatore

Alcune normative richiedono il consenso esplicito del cliente prima che i suoi dati personali possano essere raccolti. L'endpoint /consent nell'API Privacy Service consente di elaborare le richieste di consenso dei clienti e di integrarle nel flusso di lavoro per la privacy.

Prima di utilizzare questa guida, consulta la guida introduttiva per informazioni sulle intestazioni di autenticazione richieste presentate nella chiamata API di esempio seguente.

Elaborare una richiesta di consenso del cliente

Le richieste di consenso vengono elaborate effettuando una richiesta POST all'endpoint /consent.

Formato API

POST /consent

Richiesta

La richiesta seguente crea un nuovo processo di consenso per gli ID utente forniti nell'array 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"
            ]
          }
        ]
      }'
Proprietà
Descrizione
optOutOfSale
Se impostato su true, indica che gli utenti forniti in entities desiderano rinunciare alla vendita o alla condivisione dei propri dati personali.
entities
Array di oggetti che indica gli utenti a cui si applica la richiesta di consenso. Ogni oggetto contiene un namespace e un array di values che corrispondono ai singoli utenti con tale spazio dei nomi.
nameSpace
Ogni oggetto nell'array entities deve contenere uno dei spazi dei nomi di identità standard riconosciuti dall'API Privacy Service.
values
Matrice di valori per ogni utente, corrispondente al valore nameSpace specificato.
NOTE
Per ulteriori informazioni su come determinare quali valori di identità cliente inviare a Privacy Service, vedere la guida relativa a fornitura dei dati di identità.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 202 (Accepted) senza payload, a indicare che la richiesta è stata accettata da Privacy Service ed è in fase di elaborazione.

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