Delen via

REST- en antwoordheaders ondersteund door de Partner Center API

  • Artikel

van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

De REST API van Partnercentrum ondersteunt de volgende HTTP-aanvraag- en antwoordheaders. Niet alle API-aanroepen accepteren alle headers.

REST-aanvraagheaders

De REST API van Partnercentrum ondersteunt de volgende HTTP-aanvraagheaders.

Koptekst Beschrijving Waardetype
Authorization: Vereist. Het autorisatietoken in de vorm Bearer <token>. koord
Accept: Hiermee geeft u het aanvraag- en antwoordtype, application/json. tekenreeks
MS-RequestId: Een unieke id voor de aanroep, die wordt gebruikt om id-potentie te garanderen. Als er een time-out is, moet de aanroep voor opnieuw proberen dezelfde waarde bevatten. Bij ontvangst van een antwoord (geslaagd of zakelijk falen) moet de waarde opnieuw worden ingesteld voor de volgende aanroep. GUID
MS-CorrelationId: Een unieke id voor de aanroep, handig in logboeken en netwerktraceringen voor het oplossen van fouten. De waarde moet opnieuw worden ingesteld voor elke aanroep. Alle bewerkingen moeten deze header bevatten. Zie de correlatie-id-informatie in Test en foutopsporingvoor meer informatie. GUID (Globaal Unieke Identificator)
MS-Contract-Version: Vereist. Hiermee geeft u de versie van de aangevraagde API op; Deze waarde is meestal api-versie: v1, tenzij anders is opgegeven in de sectie Scenario's. tekenreeks
If-Match: Wordt gebruikt voor gelijktijdigheidsbeheer. Voor sommige API-aanroepen is het doorgeven van de ETag via de If-Match-header vereist. De ETag bevindt zich meestal op de resource en daarom is het nodig om de nieuwste versie op te halen met een GET-verzoek. Zie de ETag-informatie in Test en foutopsporingvoor meer informatie. draad
MS-PartnerCenter-Application Facultatief. Hiermee geeft u de naam op van de toepassing die gebruikmaakt van de REST API van Partnercentrum. snaar
X-Locale: Facultatief. Hiermee geeft u de taal op waarin de tarieven worden geretourneerd. De standaardwaarde is en-US. Zie partnercentrum ondersteunde talen en landinstellingenvoor een lijst met ondersteunde waarden. tekenreeks

REST-antwoordkoppen

De REST API van Partnercentrum retourneert mogelijk de volgende HTTP-antwoordheaders.

Koptekst Beschrijving Waardetype
Accept: Hiermee geeft u het aanvraag- en antwoordtype, application/json. karakterreeks
MS-RequestId: Een unieke id voor de aanroep, die wordt gebruikt om id-potentie te garanderen. Als er een time-out is, moet de aanroep voor opnieuw proberen dezelfde waarde bevatten. Bij ontvangst van een antwoord (geslaagd of zakelijk falen) moet de waarde opnieuw worden ingesteld voor de volgende aanroep. GUID
MS-CorrelationId: Een unieke id voor de aanroep. Deze waarde is handig voor het oplossen van problemen met logboeken en netwerktraceringen om de fout te vinden. De waarde moet opnieuw worden ingesteld voor elke aanroep. Alle bewerkingen moeten deze header bevatten. GUID