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