Point de terminaison du consentement

Certaines réglementations exigent un consentement explicite de la part du client avant que leurs données personnelles puissent être collectées. La variable /consent du point de terminaison Privacy Service L’API vous permet de traiter les demandes de consentement des clients et de les intégrer à votre workflow de confidentialité.

Avant d’utiliser ce guide, reportez-vous au prise en main guide pour plus d’informations sur les en-têtes d’authentification requis présentés dans l’exemple d’appel API ci-dessous.

Traitement d’une demande de consentement du client

Les demandes de consentement sont traitées en adressant une requête de POST à la fonction /consent point de terminaison .

Format d’API

POST /consent

Requête

La requête suivante crée une tâche de consentement pour les ID utilisateur fournis dans la variable entities tableau.

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"
            ]
          }
        ]
      }'
Propriété
Description
optOutOfSale
Lorsqu’elle est définie sur true, indique que les utilisateurs ont fourni entities vous souhaitez vous exclure de la vente ou du partage de leurs données personnelles.
entities
Tableau d’objets indiquant les utilisateurs auxquels s’applique la demande de consentement. Chaque objet contient une namespace et un tableau de values pour associer des utilisateurs individuels à cet espace de noms.
nameSpace
Chaque objet de la variable entities Le tableau doit contenir l’un des éléments suivants : espaces de noms d’identité standard reconnu par l’API du Privacy Service.
values
Tableau de valeurs pour chaque utilisateur, correspondant au nameSpace.
NOTE
Pour plus d’informations sur la manière de déterminer les valeurs d’identité du client à envoyer à Privacy Service, reportez-vous au guide sur fournir des données d’identité.

Réponse

Une réponse réussie renvoie un état HTTP 202 (Accepted) sans payload, indiquant que la requête a été acceptée par Privacy Service et est en cours de traitement.

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