Hlavičky REST a odpovědi v Partnerském centru podporované rozhraním REST API Partnerského centra

  • Č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, které podporuje rozhraní REST API Partnerského centra.

Hlavička Popis Typ hodnoty
Autorizace: Povinný: Autorizační token ve formuláři Nosný <token>. string
Přijmout: Určuje typ požadavku a odpovědi, application/json. string
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í, 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 najdete v informacích o ID korelace v nástroji Test a ladění. 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 Scénáře uvedeno jinak. string
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 get-ting nejnovější. Další informace najdete v informacích o značkách ETag v části Testování a ladění. string
MS-PartnerCenter-Application Nepovinné. Určuje název aplikace, která používá rozhraní REST API Partnerského centra. string
Národní prostředí X: Nepovinné. Určuje jazyk, ve kterém se vrátí sazby. Výchozí hodnota je en-US. Seznam podporovaných hodnot najdete v tématu Podporované jazyky a národní prostředí v Partnerském centru. string

Hlavičky odpovědi REST

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

Hlavička Popis Typ hodnoty
Přijmout: Určuje typ požadavku a odpovědi, application/json. string
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