Sdílet prostřednictvím

Rozhraní REST API Partnerského centra a hlavičky odpovědí podporované Partnerským centrem

  • Článek

platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Rozhraní REST API Partnerského centra podporuje následující hlavičky požadavku HTTP a odpovědi. Ne všechna volání rozhraní API přijímají všechny hlavičky.

Hlavičky požadavků REST

Rozhraní REST API Partnerského centra podporuje následující hlavičky požadavků HTTP.

Záhlaví Popis Typ hodnoty
Authorization: Povinné Autorizační token ve formátu Bearer <token>. řetězec
Accept: Určuje typ požadavku a odpovědi application/json. řetězec
MS-RequestId: Jedinečný identifikátor volání, který se používá k zajištění id-účinnosti. Pokud dojde k vypršení časového limitu, volání opakování by mělo obsahovat stejnou hodnotu. Po přijetí odpovědi (úspěch nebo selhání firmy) by se hodnota měla resetovat pro další volání. Globálně jedinečný identifikátor (GUID)
MS-CorrelationId: Jedinečný identifikátor volání, užitečný v protokolech a trasování sítě pro řešení chyb. Hodnota by se měla resetovat pro každé volání. Všechny operace by měly obsahovat tuto hlavičku. Další informace o ID korelace naleznete v části Testování a ladění. Globálně unikátní identifikátor (GUID)
MS-Contract-Version: Povinné. Určuje verzi požadovaného rozhraní API. Tato hodnota je obvykle api-version: v1, pokud není v části Scenarios uvedeno jinak. řetězec
If-Match: Používá se pro řízení souběžnosti. Některá volání rozhraní API vyžadují předání značky ETag prostřednictvím hlavičky If-Match. ETag je obvykle na prostředku, a proto vyžaduje použití GET pro získání nejnovější verze. Další informace najdete v informacích o značce ETag v testování a ladění. řetězec
MS-PartnerCenter-Application Volitelný. Určuje název aplikace, která používá rozhraní REST API Partnerského centra. řetězec
X-Locale: Volitelný. Určuje jazyk, ve kterém se vrátí sazby. Výchozí hodnota je en-US. Seznam podporovaných hodnot najdete v části podporované jazyky a oblasti v Partnerském centru. řetězec

Hlavičky odpovědi REST

Rozhraní REST API Partnerského centra může vrátit následující hlavičky odpovědi HTTP.

Záhlaví Popis Typ hodnoty
Accept: Určuje typ požadavku a odpovědi application/json. řetězec
MS-RequestId: Jedinečný identifikátor volání, který se používá k zajištění id-účinnosti. Pokud dojde k vypršení časového limitu, volání opakování by mělo obsahovat stejnou hodnotu. Po přijetí odpovědi (úspěch nebo selhání firmy) by se hodnota měla resetovat pro další volání. Identifikátor GUID
MS-CorrelationId: Jedinečný identifikátor volání. Tato hodnota je užitečná pro řešení potíží s protokoly a trasováním sítě k nalezení chyby. Hodnota by se měla resetovat pro každé volání. Všechny operace by měly obsahovat tuto hlavičku. Identifikátor GUID