检索凭据配置
platform.adobe.io/data/core/activation/authoring/credentials
此页面举例说明了API请求和有效负荷,您可以使用/authoring/credentials
API端点检索凭据配置。
何时使用/credentials
API端点 when-to-use
/credentials
API终结点。 您可以改为通过/destinations
端点的customerAuthenticationConfigurations
参数配置目标的身份验证信息。只有在Adobe和目标平台之间存在全局身份验证系统,并且Platform客户不需要提供任何身份验证凭据即可连接到目标时,才使用此API端点创建凭据配置。 在这种情况下,您必须使用/credentials
API端点创建凭据配置。
使用全局身份验证系统时,在创建新的目标配置时,必须在目标投放配置中设置"authenticationRule":"PLATFORM_AUTHENTICATION"
。
凭据API操作快速入门 get-started
在继续之前,请查看入门指南以了解成功调用API所需了解的重要信息,包括如何获取所需的目标创作权限和所需的标头。
检索凭据配置 retrieve
您可以通过向/authoring/credentials
端点发出GET
请求来检索现有凭据配置。
API格式
使用以下API格式检索帐户的所有凭据配置。
GET /authoring/credentials
使用以下API格式检索由{INSTANCE_ID}
参数定义的特定凭据配置。
GET /authoring/credentials/{INSTANCE_ID}
以下两个请求检索您的IMS组织的所有凭据配置,或特定的凭据配置,具体取决于您在请求中是否传递INSTANCE_ID
参数。
选择下面的每个选项卡以查看相应的有效负载。
accordion | ||
---|---|---|
请求 | ||
|
accordion | ||
---|---|---|
响应 | ||
成功的响应返回HTTP状态200,其中包含您有权访问的凭据配置列表,该列表基于您使用的IMS Org ID和沙盒名称。 一个
|
accordion | ||||||||
---|---|---|---|---|---|---|---|---|
请求 | ||||||||
|
accordion | ||
---|---|---|
响应 | ||
成功的响应返回HTTP状态200,其中包含与请求中提供的
|
API错误处理 error-handling
Destination SDKAPI端点遵循常规Experience PlatformAPI错误消息原则。 请参阅平台疑难解答指南中的API状态代码和请求标头错误。
后续步骤 next-steps
阅读本文档后,您现在知道如何使用/authoring/credentials
API端点检索有关凭据配置的详细信息。 阅读如何使用Destination SDK配置目标,以了解此步骤在配置目标的过程中所处的位置。