合作夥伴中心 REST 和合作夥伴中心 REST API 支援的響應標頭
適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心
合作夥伴中心 REST API 支援下列 HTTP 要求和響應標頭。 並非所有 API 呼叫都接受所有標頭。
REST 請求標頭資訊
合作夥伴中心 REST API 支援下列 HTTP 要求標頭。
| 頁眉 | 描述 | 值類型 |
|---|---|---|
Authorization: |
必填。 持有人 <令牌形式的授權權杖>。 | 字串 |
Accept: |
指定要求和回應類型，應用程式/json。 | 字串 |
MS-RequestId: |
呼叫的唯一標識碼，用來確保id-potency。 如果有逾時，重試呼叫應該包含相同的值。 收到回應（成功或業務失敗）後，應重設下次呼叫的值。 | GUID |
MS-CorrelationId: |
通話的唯一識別碼，可用於日誌和網路追蹤中，以協助錯誤的疑難排解。 每個呼叫都應該重設值。 所有作業都應該包含此標頭。 如需詳細資訊，請參閱 測試和偵錯中的相互關聯標識碼資訊。 | GUID（全域唯一識別碼） |
MS-Contract-Version: |
必填。 指定要求的 API 版本;此值通常是 api-version：v1，除非在 Scenarios 區段中另有指定。 | 字串 |
If-Match: |
用於並行控制。 某些 API 呼叫需要透過 If-Match 標頭傳遞 ETag。 ETag 通常位於資源上，因此需要以 GET 方法獲取最新版本。 如需詳細資訊，請參閱 測試和偵錯中的 ETag 資訊，。 | 字串 |
MS-PartnerCenter-Application |
自選。 指定使用合作夥伴中心 REST API 的應用程式名稱。 | 字串 |
X-Locale: |
自選。 指定回傳匯率時使用的語言。 預設值為 en-US。 若需查看支援的數值清單，請參閱 合作夥伴中心支援的語言與地區。 | 字串 |
REST 回應標頭
合作夥伴中心 REST API 可能會傳回下列 HTTP 回應標頭。
| 頁眉 | 描述 | 值類型 |
|---|---|---|
Accept: |
指定要求和回應類型，應用程式/json。 | 字串 |
MS-RequestId: |
呼叫的唯一標識碼，用來確保id-potency。 如果有逾時，重試呼叫應該包含相同的值。 收到回應（無論成功或業務失敗）時，應該重設該值，以備下次呼叫時使用。 | GUID（全域唯一識別碼） |
MS-CorrelationId: |
呼叫的唯一標識碼。 此值對於故障排除記錄和網路追蹤以尋找錯誤非常有用。 每個呼叫都應該重設值。 所有作業都應該包含此標頭。 | 全球唯一識別碼 (GUID) |