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. Le point d’entrée /consent de l’API Privacy Service 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 guide de prise en main 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 envoyant une requête de POST au point de terminaison /consent.

Format d’API

POST /consent

Requête

La requête suivante crée une tâche de consentement pour les ID utilisateur fournis dans le tableau 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"
            ]
          }
        ]
      }'
Propriété
Description
optOutOfSale
Lorsqu’elle est définie sur true, indique que les utilisateurs fournis sous entities souhaitent se désinscrire 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 un namespace et un tableau de values pour faire correspondre des utilisateurs individuels à cet espace de noms.
nameSpace
Chaque objet du tableau entities doit contenir l’un des espaces de noms d’identité standard reconnus par l’API du Privacy Service.
values
Un tableau de valeurs pour chaque utilisateur, correspondant au nameSpace fourni.
NOTE
Pour plus d'informations sur la manière de déterminer les valeurs d'identité du client à envoyer à Privacy Service, consultez le guide sur la fourniture de 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 qu’elle est en cours de traitement.

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