Marges downloaden
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"