Delen via

Wisselkoersen ophalen

In dit artikel wordt uitgelegd hoe u wisselkoersen voor een bepaalde maand kunt verkrijgen.

Vereisten

  • Referenties zoals beschreven in API-verificatie. Dit scenario biedt alleen ondersteuning voor verificatie van toepassingsgebruikers. Alleen toepassingen worden nog niet ondersteund.
  • Deze API biedt momenteel alleen ondersteuning voor gebruikerstoegang waarbij partners zich in een van de volgende rollen moeten bevinden: Beheerderagent of Verkoopagent.

Details

  • Momenteel gebruikt met get price sheet API om de verwachte kosten voor lokale munteenheden van het Azure-plan CSP te berekenen.
  • De wisselkoersen gelden voor de hele maand dat ze worden geplaatst.
  • Meer informatie over prijzen voor Azure-abonnementen vindt u in de prijsdocumentatie voor Azure-abonnementen.
  • Deze methode retourneert resultaten als een bestandsstroom. Bestandsstroom is een .csv-bestand of een gecomprimeerde zip-versie van de .csv. Hieronder vindt u meer informatie over het aanvragen van gecomprimeerde bestanden.

REST-aanvraag

Aanvraagsyntaxis

Wijze Aanvraag-URI
GET https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='{month}')/$value

Vereiste URI-parameters

Gebruik de volgende padparameters om de gewenste maand van de wisselkoersen aan te vragen.

Name Soort Vereist Beschrijving
Maand tekenreeks Ja Moet in JJJJMM-formaat zijn. Als er niets is opgegeven, wordt standaard de huidige maand gebruikt.

Aanvraagheaders

Naast de bovenstaande headers kunnen bestanden worden opgehaald als gecomprimeerd, waardoor de bandbreedte en downloadtijden worden verminderd. De bestanden worden standaard niet gecomprimeerd. Als u gecomprimeerde versies van de bestanden wilt ophalen, kunt u de onderstaande headerwaarde opnemen. Realiseer u dat gecomprimeerde bladen alleen beschikbaar zijn vanaf april 2020, alle aanvragen vóór april 2020 alleen beschikbaar zijn als niet gecomprimeerd.

Koptekst Waardetype: Waarde Beschrijving
Accept-Encoding tekenreeks leeg laten lopen Optioneel. Als de bestandsstroom wordt weggelaten, wordt deze niet gecomprimeerd.

Aanvraagvoorbeeld

GET https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='201909')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

REST-antwoord

Als dit lukt, retourneert deze methode de wisselkoersen als een bestandsstroom. Bestandsstroom is een .csv-bestand of een gecomprimeerde zip-versie van de .csv.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of falen, en aanvullende debugging informatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 18548
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=fxrates
Request-ID: 65fb6e59-051b-42f7-8771-c8c139b3c901
Date: Wed, 02 Oct 2019 03:42:54 GMT

"CurrencyCode","USDPerUnit","Month"
"AED","0.27224589249009701","2019”
======= Truncated ==============

Gerelateerde inhoud