許可端點

某些法規要求客戶明確同意才能收集其個人資料。 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: {IMS_ORG}' \
  -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 ServiceAPI所識別的標準身份名稱空間中的一個。
values 每個用戶的值陣列,與提供的nameSpace相對應。
注意

有關如何確定要發送到Privacy Service的客戶身份值的詳細資訊,請參閱提供身份資料的指南。

回應

成功的回應會傳回沒有裝載的HTTP狀態202(已接受),指出Privacy Service已接受請求,且正在處理中。

本頁內容