Endpoint di consenso

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

Prima di utilizzare questa guida, consultare introduzione guida per informazioni sulle intestazioni di autenticazione richieste presentate nella chiamata API di esempio di seguito.

Elaborare una richiesta di consenso del cliente

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

Formato API

POST /consent

Richiesta

La seguente richiesta crea un nuovo processo di consenso per gli ID utente forniti in entities array.

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 loro 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 affinché i singoli utenti corrispondano a quello spazio dei nomi.
nameSpace Ogni oggetto in entities l'array deve contenere uno dei spazi dei nomi di identità standard riconosciuto dall’API Privacy Service.
values Un array di valori per ogni utente, corrispondente al fornito nameSpace.
NOTA

Per ulteriori informazioni su come determinare quali valori di identità cliente inviare a Privacy Service, consulta la guida fornitura di dati di identità.

Risposta

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

In questa pagina