Loading
資料防護與隱私性
使用 REST API 建立偏好設定表單存取權杖

使用 REST API 建立偏好設定表單存取權杖

使用 REST API 為「偏好設定管理員」表單建立存取權杖。

必要版本

產生存取權杖後,將存取權杖字串 ?pctoken=[token string] 附加至您已發佈網站的網站 URL。然後將此 URL 傳送給您的使用者,讓他們無須登入即可存取偏好設定表單。

提供版本:Developer、Enterprise、Performance 及 Unlimited Edition。需要 Salesforce 隱私權中心授權。
需要的使用者權限
使用「偏好設定管理員產生器」: ManagePreferenceManager

語法

URI services/data/vXX.X/consent/prefcenter/token
格式 JSON
HTTP 方法 POST
驗證 承載者權杖
要求參數 recordId
要求內文

要求內文包含具有相關聯物件記錄識別碼的 JSON 物件。

{
  [recordId]            // String, Required
}
回應內文

回應內文會傳回 JSON 物件,其中包含與所提供 recordId 相關聯使用者的權杖。

{
  "success":                     // Boolean
  "tokenMapping": {              // Object
  "token": "xxxxxxxxxxxxxxxx"    // String
                  },
  "tokenErrors": {},             // Object 
  "error": ""                    // String 
}
  • success 會傳回 true 或 false 陳述式,以表示要求是否成功。
  • tokenErrors 表示撤銷權杖是否發生錯誤。如果您包含多個權杖,則回應會指出每個個別權杖發生任何錯誤。
  • error 表示處理要求時是否發生系統錯誤。

回應內文範例

此範例顯示記錄識別碼為 0034L00000CZqeqQAD 的要求成功回應。


{
  "success" : true,
  "tokenMapping" : 
    {
    "token": "QTRMMDAwMDAwNTRQSGc0ZlhSczZnSXNTNEpNUVBldWN6
              cFl0bDRNcERURWRMWGJPZ1hhamxQTnUxa2oxN0dXVVFM
              alhwNFY1NXVxaDlrcXEwcFhuQy94WGNBYmMyMkZaWjJR
              L1VTOWw0UVhiZ2s4dFZaMUM0M053M01wWllUUTQzODZ1
              VjFLekxod2xQZ2NNQzRIYzNuM2RtRW9kVTRTN1lEdz09"
    },
  "tokenErrors": {},
  "error": ""
}

 
正在載入
Salesforce Help | Article