Rest- en antwoordheaders van Partnercentrum die worden ondersteund door de REST API van Partnercentrum
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 |