동의 엔드포인트

특정 규정에서는 개인 데이터를 수집하기 전에 명시적인 고객 동의를 요구합니다. Privacy Service API의 /consent 끝점을 사용하면 고객 동의 요청을 처리하고 이를 개인 정보 보호 워크플로에 통합할 수 있습니다.

이 안내서를 사용하기 전에 아래 예제 API 호출에 제공된 필수 인증 헤더에 대한 정보는 시작하기 안내서를 참조하십시오.

고객 동의 요청 처리

동의 요청은 /consent 끝점에 대한 POST 요청을 통해 처리됩니다.

API 형식

POST /consent

요청

다음 요청은 entities 배열에 제공된 사용자 ID에 대한 새 동의 작업을 만듭니다.

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"
            ]
          }
        ]
      }'
속성
설명
optOutOfSale
true로 설정하면 entities 아래에 제공된 사용자가 개인 데이터 판매 또는 공유를 거부하려고 함을 나타냅니다.
entities
동의 요청이 적용되는 사용자를 나타내는 객체의 배열입니다. 각 개체에는 해당 네임스페이스와 개별 사용자를 일치시키기 위한 namespacevalues 배열이 포함되어 있습니다.
nameSpace
entities 배열의 각 개체는 Privacy Service API에서 인식하는 표준 ID 네임스페이스 중 하나를 포함해야 합니다.
values
제공된 nameSpace에 해당하는 각 사용자에 대한 값의 배열입니다.
NOTE
Privacy Service에 보낼 고객 ID 값을 결정하는 방법에 대한 자세한 내용은 ID 데이터 제공에 대한 안내서를 참조하십시오.

응답

성공한 응답은 페이로드가 없는 HTTP 상태 202(허용됨)를 반환하며, 이는 요청이 Privacy Service에 의해 수락되었고 처리 중임을 나타냅니다.

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