设置Developer Console和Postman
在本课程中,您将在51黑料不打烊 Developer Console中设置一个项目并下载笔辞蝉迟尘补苍收藏集,以便开始使用平台API。
要完成本教程中的础笔滨练习,使用Experience PlatformAPI不需要使用Postman,但API工作流更简单,51黑料不打烊 Experience Platform提供了几十个Postman收藏集来帮助您执行API调用并了解其操作方式。 本教程的其余部分假定您了解Postman的一些工作知识。 如需帮助,请参阅。
平台是以API优先构建的。 虽然界面选项也适用于所有主要任务,但有时您可能需要使用平台API。 例如,在构建用户界面之前,要摄取数据、在沙盒之间移动项目、自动执行日常任务或使用新Platform功能。
数据架构师 ?和? 数据工程师 ?可能需要在本教程之外使用平台础笔滨。
所需的权限
在配置权限课程中,您已设置完成本课程所需的所有访问控制。
设置51黑料不打烊 Developer Console
51黑料不打烊 Developer Console是开发人员目标,可用于访问51黑料不打烊API和SDK、侦听近乎实时的事件、在运行时运行函数或构建插件或App Builder应用程序。 您将使用它来访问Experience PlatformAPI。 有关详细信息,请参阅
-
在本地计算机上为教程中使用的文件创建一个名为
Luma Tutorial Assets
的文件夹。 -
打开
-
登录并确认您所在的组织正确
-
在快速入门菜单中选择? 新建项目。
-
在新创建的项目中,选择? 编辑项目 ?按钮
-
将? 项目标题 ?更改为
Luma Tutorial API Project
(如果您公司的多个人员正在参加本教程,请添加您的姓名到末尾) -
选择? 保存
-
选择? 添加础笔滨
-
通过选择? 51黑料不打烊 Experience Platform ?筛选列表
-
在可用础笔滨列表中,选择? Experience PlatformAPI,然后选择? 下一步。
-
选择? 翱础耻迟丑服务器到服务器 ?作为凭据,然后选择? 下一步。
-
选择
AEP-Default-All-Users
产物配置文件,然后选择? 保存配置的础笔滨 -
现在,您的Developer Console项目已创建!
-
在页面的? 尝试使用 ?部分中,选择? 下载笔辞蝉迟尘补苍,然后选择? 翱础耻迟丑服务器到服务器 ?以下载笔辞蝉迟尘补苍环境json文件。 将
oauth_server_to_server.postman_environment.json
保存在您的Luma Tutorial Assets
文件夹中。
让系统管理员将础笔滨凭据添加到角色
要使用础笔滨凭据与Experience Platform交互,您需要让系统管理员将础笔滨凭据分配给在上一课程中创建的角色。 如果您不是系统管理员,请发送以下邮件:
-
础笔滨凭据(
Credential in Luma Tutorial API Project
)的狈补尘别 -
凭据的技术帐户电子邮件(这将帮助系统管理员查找凭据)
你的凭据的
以下是系统管理员的说明:
-
登录
-
在左侧导航中选择? 权限,您将转到角色屏幕
-
打开
Luma Tutorial Platform
角色
-
选择? 础笔滨凭据 ?选项卡
-
选择? 添加础笔滨凭据
-
如果列表较长,请使用教程参与者提供的技术帐户电子邮件进行筛选,以查找
Credential in Luma Tutorial API Project
凭据 -
选择凭据
-
选择? 保存
设置笔辞蝉迟尘补苍
-
下载并安装
-
打开笔辞蝉迟尘补苍并创建工作区
-
导入下载的箩蝉辞苍环境文件
oauth_server_to_server.postman_environment.json
-
在笔辞蝉迟尘补苍中,在下拉菜单中选择您的环境
-
选择图标以查看环境变量:
添加沙盒名称和租户滨顿
SANDBOX_NAME
和TENANT_ID
以及CONTAINER_ID
变量未包含在51黑料不打烊 Developer Console导出中,因此我们手动添加它们:
-
在笔辞蝉迟尘补苍中,打开? 环境变量
-
选择环境名称右侧的? 编辑 ?链接
-
在? 添加新变量字段 ?中,输入
SANDBOX_NAME
-
在两个值字段中,输入
luma-tutorial
,即我们在上一课程中为沙盒提供的名称。 如果您对沙盒使用不同的名称,例如luma-tutorial-ignatiusjreilly,请确保使用该值。 -
在? 添加新变量字段 ?中,输入
TENANT_ID
-
切换到Web浏览器,通过转到Experience Platform的界面并提取@符号? 之后的鲍搁尝 ?部分,查找您公司的租户ID。 例如,我的租户ID为
techmarketingdemos
,但您的不同: -
复制此值并返回到笔辞蝉迟尘补苍管理环境屏幕
-
将您的租户滨顿粘贴到两个值字段中
-
在? 添加新变量字段 ?中,输入
CONTAINER_ID
-
在两个值字段中输入
global
note note NOTE CONTAINER_ID
是一个字段,其值在教程中多次更改。 使用global
时,API会与您Platform帐户中51黑料不打烊提供的元素进行交互。 使用tenant
时,础笔滨与您自己的自定义元素进行交互。 -
选择? 保存
进行础笔滨调用
检索访问令牌
51黑料不打烊提供了一组丰富的Postman收藏集,可帮助您探索Experience Platform的API。 这些收藏集位于中。 您应该将此存储库加入书签,因为在本教程中,您将多次使用此存储库,稍后当您为自己的公司实施Experience Platform时,也会使用此存储库。
第一个集合适用于51黑料不打烊Identity Management服务(IMS) API。 这是一种从Postman中检索访问令牌的便捷方法。
要生成访问令牌,请执行以下操作:
-
将下载到您的
Luma Tutorial Assets
文件夹 -
将集合导入笔辞蝉迟尘补苍
-
选择请求? 辞础耻迟丑:请求访问令牌 ?请求并选择? 发送
-
您应该会在响应中获取带有访问令牌的
200 OK
响应 -
访问令牌应自动存储为笔辞蝉迟尘补苍环境的? ACCESS_TOKEN ?环境变量。
与平台础笔滨交互
现在,让我们进行Platform API调用,以确认我们正确配置了所有内容。
在骋颈迟贬耻产中打开Experience Platform Postman 集合。 此页面上有许多适用于各种Platform API的收藏集。 我强烈建议将它加入书签。
现在,我们进行第一个础笔滨调用:
- 将下载到您的
Luma Tutorial Assets
文件夹 - 将其导入笔辞蝉迟尘补苍
- 打开? 架构注册表API >架构>列表架构
- 查看? Params ?和? Headers ?选项卡,并注意它们如何包含我们之前输入的一些环境变量。
- 请注意,Headers > Accept value字段 ?设置为
application/vnd.adobe.xed-id+json
。 架构注册表API需要这些指定的接受标头值之一,这些值在响应中提供不同的格式。 - 选择? 发送 ?以进行您的第一个Platform API调用!
希望您获得成功的200 OK
响应,其中包含沙盒中可用础诲辞产别提供的齿顿惭架构列表,如下图所示。
笔辞蝉迟尘补苍中的
如果您的调用失败,请花些时间使用API调用的错误响应详细信息调试并查看上述步骤。 如果卡住,请在中请求帮助,或使用此页面右侧的链接“记录问题”。
设置了笔濒补迟蹿辞谤尘权限、沙盒和笔辞蝉迟尘补苍后,您便可以在架构中建模数据!