合作伙伴中心 REST API 支持的合作伙伴中心 REST 和响应头
适用于：合作伙伴中心 |由世纪互联运营的合作伙伴中心 |美国政府Microsoft云合作伙伴中心
合作伙伴中心 REST API 支持以下 HTTP 请求和响应标头。 并非所有 API 调用都接受所有标头。
REST 请求头
合作伙伴中心 REST API 支持以下 HTTP 请求标头。
| 标头 | 描述 | 值类型 |
|---|---|---|
Authorization: |
必填。 持有者令牌形式的授权令牌<>。 | 字符串 |
Accept: |
指定请求和响应类型，application/json。 | 字符串 |
MS-RequestId: |
调用的唯一标识符，用于确保 id-potency。 如果超时，重试调用应包含相同的值。 收到响应（成功或业务失败）后，应重置下一个调用的值。 | GUID |
MS-CorrelationId: |
调用的唯一标识符，在日志和网络跟踪中非常有用，用于排查错误。 每次调用时应重置该值。 所有操作都应包含此标头。 有关详细信息，请参阅测试和调试中的相关 ID 信息。 | GUID |
MS-Contract-Version: |
必填。 指定请求的 API 版本;此值通常是 api 版本：v1，除非在 方案 部分中另有指定。 | 字符串 |
If-Match: |
用于并发控制。 某些 API 调用需要通过 If-Match 标头传递 ETag。 ETag 通常位于资源上，因此需要通过 GET 请求获取最新版本。 有关详细信息，请参阅 测试和调试中的 ETag 信息。 | 字符串 |
MS-PartnerCenter-Application |
自选。 指定使用合作伙伴中心 REST API 的应用程序的名称。 | 字符串 |
X-Locale: |
自选。 指定返回费率的语言。 默认值为 en-US。 有关支持值的列表，请参阅合作伙伴中心支持的语言和区域设置。 | 字符串 |
REST 响应头
合作伙伴中心 REST API 可能会返回以下 HTTP 响应标头。
| 标头 | 描述 | 值类型 |
|---|---|---|
Accept: |
指定请求和响应类型，application/json。 | 字符串 |
MS-RequestId: |
调用的唯一标识符，用于确保 id-potency。 如果超时，重试调用应包含相同的值。 收到响应（成功或业务失败）后，应重置下一个调用的值。 | GUID |
MS-CorrelationId: |
调用的唯一标识符。 此值可用于排查日志和网络跟踪以查找错误。 每次调用都应重置该值。 所有操作都应包含此标头。 | GUID |