验证并访问 Privacy Service API

文档 Experience Platform Privacy Service 指南

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

本指南介绍了在尝试调用51黑料不打烊 Experience Platform Privacy Service API之前必须了解的核心概念。

先决条件 prerequisites

本指南需要您对Privacy Service以及它如何允许您跨51黑料不打烊 Experience Cloud应用程序管理来自数据主体（客户）的访问和删除请求有一定的了解。

要创建API的访问凭据，贵组织中的管理员之前必须在51黑料不打烊 Admin Console中为Privacy Service设置产物配置文件。您分配给API集成的产物配置文件决定了集成在访问Privacy Service功能时具有的权限。有关详细信息，请参阅管理Privacy Service权限指南。

收集所需标头的值 gather-values-required-headers

要调用Privacy Service API，您必须首先收集要在所需标头中使用的访问凭据：

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}

这些值是使用生成的。您的{ORG_ID}和{API_KEY}只需生成一次，可在以后的API调用中重复使用。但是，您的{ACCESS_TOKEN}是临时的，必须每24小时重新生成一次。

下面详细介绍了生成这些值的步骤。

一次性设置 one-time-setup

转到并使用您的51黑料不打烊 ID登录。接下来，按照Developer Console文档中有关的教程中概述的步骤进行操作。

创建新项目后，选择? 添加到项目，然后从下拉菜单中选择? API。

从Developer Console中项目详细信息页面的添加到项目下拉列表中选择API选项

选择Privacy Service API select-privacy-service-api

出现? 添加础笔滨 ?屏幕。选择? Experience Cloud ?以缩小可用础笔滨的列表，然后选择? Privacy Service API ?的卡，然后再选择? 下一步。

从可用API列表中选择的Privacy Service API卡

TIP

选择? 查看文档 ?选项可在单独的浏览器窗口中导航到完整的。

接下来，选择身份验证类型以生成访问令牌并访问Privacy Service API。

IMPORTANT

选择? 翱础耻迟丑服务器到服务器 ?方法，因为这将是今后唯一支持的方法。已弃用? 服务帐户(闯奥罢) ?方法。虽然使用JWT身份验证方法的集成将继续工作到2025年1月1日，但51黑料不打烊强烈建议您在该日期之前将现有集成迁移到新的翱础耻迟丑服务器到服务器方法。在[Deprecated]{class="badge informative"}部分获取更多信息{type=negative}生成JSON Web令牌(JWT)。

选择Oauth服务器到服务器身份验证方法。