Marges downloaden

Artikel
03/07/2025

Van toepassing op: Partnercentrum

Juiste rollen: Beheerdersagent

Partners kunnen een lijst met actieve marges voor een bepaalde partner ophalen. Deze methode retourneert marges op basis van de partner en beschikbare begin- en einddatums. Download marges geeft de gegevens terug in een door komma's gescheiden formaat.

Vereisten

Referenties zoals beschreven in authenticatie van het Partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

REST-aanvraag

[GET] /v1/margins/download

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/margins/download?country={countrycode} HTTP/1.1

Voor een lijst met landcodes, zie Co-sell land-, regio-, staat- en provinciecodes.

URI-parameter

Deze tabel bevat de vereiste queryparameters.

Name	Type	Vereist	Beschrijving
land	String	J	De waarde is een tekenreeks die de landcode aangeeft.

Verzoekkopteksten

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/margins/download?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST-antwoord

Als dit lukt, retourneert deze methode de prijslijst als een bestandsstroom als a.csv bestand

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het succesvol was of dat er een fout was, en meer foutopsporingsinformatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

"b82103f870af_e71f19b1-27cf-43d3-be46-3d87a9d908a2","US","Percentage","Test PMC 2 PC","DZH318Z0FTST","HelloWorld3","0002","plan1","Dynamics 365","3b274863-227e-4b2c-a463-330b949e2e34","3pptesting","8.0","","","","","","","","","8/14/2023 6:09:28 PM","10/31/2023 11:59:59 PM","live","8/14/2023 6:09:28 PM"

Delen via