Rest- en antwoordheaders van Partnercentrum die worden ondersteund door de REST API van Partnercentrum

  • 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 Partner center ondersteunt de volgende HTTP-aanvraagheaders die worden ondersteund door de REST API van Partnercentrum.

Koptekst Beschrijving Waardetype
Autorisatie: Vereist. Het autorisatietoken in het formulier Bearer-token<>. tekenreeks
Accepteren: Hiermee geeft u het aanvraag- en antwoordtype, toepassing/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 foutopsporing voor meer informatie. GUID
MS-Contract-Version: Vereist. Hiermee geeft u de versie van de aangevraagde API op; Deze waarde is meestal api-versie: v1, tenzij anders opgegeven in de sectie Scenario's . tekenreeks
If-Match: Wordt gebruikt voor gelijktijdigheidsbeheer. Voor sommige API-aanroepen moet de ETag worden doorgegeven via de If-Match-header. De ETag bevindt zich meestal op de resource en vereist daarom get-ting van de meest recente. Zie de ETag-informatie in Test en foutopsporing voor meer informatie. tekenreeks
MS-PartnerCenter-Application Optioneel. Hiermee geeft u de naam op van de toepassing die gebruikmaakt van de REST API van Partnercentrum. tekenreeks
X-landinstelling: Optioneel. Hiermee geeft u de taal op waarin de tarieven worden geretourneerd. De standaardwaarde is en-US. Zie Ondersteunde talen en landinstellingen van Partner Center voor een lijst met ondersteunde waarden. tekenreeks

REST-antwoordheaders

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

Koptekst Beschrijving Waardetype
Accepteren: Hiermee geeft u het aanvraag- en antwoordtype, toepassing/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. 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