合作夥伴中心 REST 和合作夥伴中心 REST API 支援的響應標頭
適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
合作夥伴中心 REST API 支援下列 HTTP 要求和響應標頭。 並非所有的 API 呼叫都會接受所有標頭。
REST 要求標頭
合作夥伴中心 REST API 支援合作夥伴中心 REST API 支援下列 HTTP 要求標頭。
| 標頭 | 描述 | 值類型 |
|---|---|---|
| Authorization: | 必要。 採用持有人<權杖>格式的授權權杖。 | string |
| 接受： | 指定要求和回應類型 application/json。 | string |
| MS-RequestId： | 呼叫的唯一識別碼，用來確保 id-potency。 如果有逾時，重試呼叫應該包含相同的值。 收到回應 (成功或業務失敗) 時，應針對下一個呼叫重設此值。 | GUID |
| MS-CorrelationId： | 呼叫的唯一識別碼，適用於要用來針對錯誤進行疑難排解的記錄和網路追蹤。 應針對每個呼叫重設此值。 所有作業都應該包含這個標頭。 如需詳細資訊，請參閱測試和偵錯中的相互關聯標識符資訊。 | GUID |
| MS-Contract-Version： | 必要。 指定要求的 API 版本;此值通常是 api-version：v1，除非在 [案例 ] 區段中另有指定。 | string |
| If-Match： | 用於並行存取控制。 某些 API 呼叫需要透過 If-Match 標頭來傳遞 ETag。 ETag 通常位於資源上，因此需要最新的 GET-ting。 如需詳細資訊，請參閱測試和偵錯中的ETag資訊。 | string |
| MS-PartnerCenter-Application | 選擇性。 指定使用合作夥伴中心 REST API 的應用程式名稱。 | string |
| X-Locale： | 選擇性。 指定傳回速率的語言。 預設值為 en-US。 如需支援值的清單，請參閱 合作夥伴中心支援的語言和地區設定。 | string |
REST 回應標頭
合作夥伴中心 REST API 可能會傳回下列 HTTP 回應標頭：
| 標頭 | 描述 | 值類型 |
|---|---|---|
| 接受： | 指定要求和回應類型 application/json。 | string |
| MS-RequestId： | 呼叫的唯一識別碼，用來確保 id-potency。 如果有逾時，重試呼叫應該包含相同的值。 收到回應 (成功或業務失敗) 時，應針對下一個呼叫重設此值。 | GUID |
| MS-CorrelationId： | 呼叫的唯一標識碼。 此值適用於針對記錄和網路追蹤進行疑難解答，以尋找錯誤。 應針對每個呼叫重設此值。 所有作業都應該包含這個標頭。 | GUID |