使用英语阅读

通过


合作伙伴中心 REST API 支持的合作伙伴中心 REST 和响应标头

适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

合作伙伴中心 REST API 支持以下 HTTP 请求和响应标头。 并非所有 API 调用都接受所有标头。

REST 请求标头

合作伙伴中心 REST API 支持合作伙伴中心 REST API 支持以下 HTTP 请求标头。

标头 说明 值类型
Authorization: 必需。 Authorization 标头采用 Bearer <token> 形式。 string
接受: 指定请求和响应类型 application /json string
MS-RequestId: 调用的唯一标识符,用于确保 ID 强度。 如果超时,重试调用应包含相同的值。 收到响应(业务成功或失败)后,应针对下一次调用重置此值。 GUID
MS-CorrelationId: 调用的唯一标识符,在日志和网络跟踪中用于排查错误。 应重置每个调用的此值。 所有操作都应包含此标头。 有关详细信息,请参阅测试和调试中的关联 ID 信息。 GUID
MS-Contract-Version: 必需。 指定请求的 API 版本;此值通常是 api 版本:v1,除非在 “方案” 部分另有指定。 string
If-Match: 用于并发控制。 某些 API 调用要求通过 If-Match 标头来传递 ETag。 ETag 通常位于资源上,因此需要通过 GET 操作获取最新值。 有关详细信息,请参阅测试和调试中的 ETag 信息。 string
MS-PartnerCenter-Application 可选。 指定使用合作伙伴中心 REST API 的应用程序的名称。 string
X 区域设置: 可选。 指定返回速率的语言。 默认值为 en-US。 有关支持值的列表,请参阅 合作伙伴中心支持的语言和区域设置 string

REST 响应标头

合作伙伴中心 REST API 可能会返回以下 HTTP 响应标头:

标头 说明 值类型
接受: 指定请求和响应类型 application /json string
MS-RequestId: 调用的唯一标识符,用于确保 ID 强度。 如果超时,重试调用应包含相同的值。 收到响应(业务成功或失败)后,应针对下一次调用重置此值。 GUID
MS-CorrelationId: 调用的唯一标识符。 此值可用于排查日志和网络跟踪以查找错误。 应重置每个调用的此值。 所有操作都应包含此标头。 GUID