合作伙伴中心 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