合作伙伴中心 REST API 支持的合作伙伴中心 REST 和响应标头
适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
合作伙伴中心 REST API 支持以下 HTTP 请求和响应标头。 并非所有 API 调用都接受所有标头。
合作伙伴中心 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 API 可能会返回以下 HTTP 响应标头:
标头 | 说明 | 值类型 |
---|---|---|
接受: | 指定请求和响应类型 application /json。 | string |
MS-RequestId: | 调用的唯一标识符,用于确保 ID 强度。 如果超时,重试调用应包含相同的值。 收到响应(业务成功或失败)后,应针对下一次调用重置此值。 | GUID |
MS-CorrelationId: | 调用的唯一标识符。 此值可用于排查日志和网络跟踪以查找错误。 应重置每个调用的此值。 所有操作都应包含此标头。 | GUID |