Need vastused käsitlevad valuutaandmete API-ga integreerimisega seotud levinud tehnilisi küsimusi. Kõiki lõpp-punkte ja parameetreid vaadake API dokumentatsioonist. Meie kursside ülevaate leiate artiklist Kuidas valuutaandmete API töötab?

Selles artiklis

• Millist lõpp-punkti peaksin iga kursitüübi jaoks kasutama?
• Kuidas saada täielik valuutade loend?
• Milliseid valuutapaare pakkumis- ja müügikursi lõpp-punkt hõlmab?
• Kuidas API aegunud valuutasid käsitleb?
• Kuidas saada keskpanga pakkumis- ja müügikursse?
• Miks näib keskpanga kurss olevat eelmisest päevast?
• Kas võin API-st saadud kursse vahemällu salvestada?
• Kuidas saada eelmise päeva kurss oma fikseerimisajal?
• Kuidas leida API SSL-sertifikaat?
• Miks tekivad ajalõpud või 500 vead?
• Kas pean IP-aadressid lubatud loendisse lisama?
• Miks tekivad 401 või 403 vead?

Millist lõpp-punkti peaksin iga kursitüübi jaoks kasutama?

Krüptovaluutade kursid pärinevad meie keskmistest turukurssidest, seega tuleb neid taotleda keskmiste turukursside lõpp-punktide kaudu. Nende kaasamiseks lisage oma päringule crypto=true.

Kuidas saada täielik valuutade loend?

Kasutage lõpp-punkti /v2/currencies. Iga valuuta kohta kuvatakse:

• kas tegemist on ISO 4217 koodiga
• kasutuselevõtu kuupäev ja aegunud valuuta korral selle käibelt kõrvaldamise kuupäev
• kuupäevad, millest alates ja milleni meie kursid selle valuuta kohta kehtivad
• valuuta, mis selle asendas, ning võimalik seotud valuuta

Vaikimisi sisaldab loend aktiivseid ja aegunud valuutasid. Selle muutmiseks tehke järgmist:

• lisage obsolete=true, et kuvada ainult aegunud valuutasid, mille kohta meil on ajaloolised andmed
• lisage obsolete=false, et asendada aegunud valuutad neid asendanud valuutaga

Milliseid valuutapaare pakkumis- ja müügikursi lõpp-punkt hõlmab?

Lõpp-punkt /v1/bid_ask hõlmab valuutasid AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK ja USD.

Saate taotleda mis tahes paari mõlemas suunas, välja arvatud järgmised CNH-ga (Hiina offshore-jüaaniga) seotud paarid:

• CNH ei ole saadaval koos BRL-i, DKK ega PLN-iga kummaski suunas.
• CNH on NOK-i ja SEK-i puhul saadaval ainult sihtvaluutana. Näiteks saate taotleda from=NOK&to=CNH, kuid mitte from=CNH&to=NOK.

Kuidas API aegunud valuutasid käsitleb?

Valuutade nimed muutuvad mõnikord, valuutasid denomineeritakse ümber või kõrvaldatakse käibelt. Vaikimisi vastab API tänapäeval kasutatavas valuutas, seega kui taotlete käibelt kõrvaldatud koodi, saate kursid selle asendanud valuuta kohta. Käibelt kõrvaldatud koodi enda kohta kursside saamiseks lisage oma päringule obsolete=true.

Arvutame aegunud valuuta kursid pärast selle käibelt kõrvaldamise kuupäeva selle fikseeritud seose põhjal seda asendanud valuutaga. See hoiab pikad ajalood järjepidevana, kuid need ei ole turukursid.

Lisateavet, sealhulgas selle kohta, kuidas arvutame keskmisi ja statistikat valuuta muutumise ajal, leiate API dokumentatsiooni jaotisest Ajaloolised kursid ja aegunud valuutad.

Kuidas saada keskpanga pakkumis- ja müügikursse?

Lisage oma /v1/central_bank_rate päringule fields=mid,bid,ask. Ilma selleta saate ainult keskmise kursi.

• Pakkumis- ja müügikursid saate ainult nendelt keskpankadelt, kes neid avaldavad. Neid avaldab 37 keskpanka 100-st, sealhulgas Jaapani Pank, Hongkongi rahandusamet, Brasiilia keskpank ja Tai Pank. Euroopa Keskpank, Inglise Pank ja New Yorgi Föderaalreservi Pank avaldavad ainult viitekursse. API dokumentatsiooni veerus Bid/Ask on näidatud, millised pangad neid avaldavad.
• Pakkumis- ja müügikursid on saadaval ainult hetke kursside kohta. Kui lisate päringule date, saate ainult keskmised kursid.
• Need on kursid, mida iga keskpank avaldab. Need erinevad Xe enda pakkumis- ja müügikurssidest, mida pakub lõpp-punkt /v1/bid_ask.

Miks näib keskpanga kurss olevat eelmisest päevast?

Kui te kuupäeva ei määra, tagastab /v1/central_bank_rate UTC-ajavööndis timestamp-i. Kui teisendate selle oma kohalikku aega, võib kurss näida olevat eelmisest päevast.

Panga enda kohaliku kuupäeva saamiseks lisage päringule use_bank_date=true. Näiteks Euroopa Keskpanga puhul saate 2026-08-17, mitte 2026-08-16T22:00:00Z. See toimib JSON-, XML- ja CSV-vastustega.

Kas võin API-st saadud kursse vahemällu salvestada?

Jah, piiratud aja jooksul. Vahemällu salvestamine aitab integratsioonil kiiremini töötada ja vähendab tehtavate päringute arvu. Eemaldage vahemällu salvestatud kursid, kui need pole enam ajakohased. Vahemällu salvestamine tähendab kursside ajutist säilitamist, mitte nende püsivat talletamist.

Kuidas saada eelmise päeva kurss oma fikseerimisajal?

Kutsuge /v1/historic_rate, kasutades date=YYYY-MM-DD ja use_lock_in_time=true. Saate kursi sellisena, nagu see oli teie konto igapäevasel fikseerimisajal sellel päeval. Näiteks saate seda kasutada reede kursi saamiseks järgneva nädala jooksul.

Teie fikseerimisaeg ei mõjuta keskpanga kursse. Need järgivad iga panga enda avaldamisgraafikut.

Kuidas leida API SSL-sertifikaat?

Sertifikaadi saate alla laadida oma brauserist, kasutades Chrome'i või Edge'i.

Chrome'is

1. Avage Chrome ja minge aadressile https://dfs.xe.com/dfs või https://xecdapi.xe.com/v1.

2. Valige aadressiriba vasakul asuv saidi teabe ikoon.

   

3. Valige Ühendus on turvaline ja seejärel Sertifikaat on kehtiv.

   

4. Avage sertifikaadi üksikasjade aknas vahekaart Üksikasjad.

   

5. Sertifikaadi süsteemi allalaadimiseks valige Ekspordi.

   

Edge'is

1. Minge aadressile https://dfs.xe.com/dfs või https://xecdapi.xe.com/v1.

2. Valige aadressiribal tabaluku ikoon.

   

3. Valige Ühendus on turvaline.
4. Valige hüpikakna paremas ülanurgas sertifikaadi ikoon.

5. Avage sertifikaadiaknas vahekaart Üksikasjad.

   

6. Sertifikaadi allalaadimiseks valige Ekspordi.
   
   

Miks tekivad ajalõpud või 500 vead?

Enamik ajutisi ajalõppe ja 5xx-vigu saab alguse teie süsteemi ja meie süsteemi vahelisest võrgust või lüüsist. Enne meiega ühenduse võtmist kontrollige järgmist:

• Lüüsid ja vahevara: kui kutsute API-t integratsiooniplatvormi või API-lüüsi kaudu, kontrollige esmalt selle logisid. Selle enda tekitatud vead võivad näida meie API vigadena.
• DNS: ärge kodeerige meie IP-aadressi püsivalt ega salvestage seda vahemällu. Lahendage xecdapi.xe.com tavapäraselt ja järgige DNS-i TTL-e, sest selle taga olev IP-aadress võib muutuda.
• Ajalõpud ja ühendusekogumid: veenduge, et teie kliendi seaded arvestavad päringute mahuga. Saatke suured partiid hajutatult, mitte kõiki korraga.
• TLS: teie klient peab toetama TLS 1.2 või uuemat koos tänapäevaste (GCM) šifrikomplektidega. Vanemad platvormid, näiteks Java 7 või pärandversioon .NET-ist, võivad pakkuda ainult CBC-šifreid, mille kasutamisest me loobume. Oma klienti saate testida aadressil https://xecd-rates-api-test.xe.com/, mis aktsepteerib ainult TLS 1.3 ning GCM-iga TLS 1.2.

Kui vead jätkuvad, saatke meile e-kiri aadressil data@xe.com, lisades oma konto ID, lõpp-punkti ja parameetrid, tõrgete UTC-ajad ning täieliku veavastuse.

Kas pean IP-aadressid lubatud loendisse lisama?

Ei. Valuutaandmete API ei piira helistajaid IP-aadressi alusel. Saate kutsuda https://xecdapi.xe.com-i mis tahes avalikult IP-aadressilt ning te ei pea oma aadressi meile registreerima.

Kui teie tulemüür lubab väljamineva liikluse ainult kindlatele IP-aadressidele, kasutage meie staatilise IP-ga lõpp-punkti xecd-proxy.xe.com ja lisage selle IP-aadress oma lubatud loendisse. Praeguse IP-aadressi saamiseks. Me saadame kõigile seda lõpp-punkti kasutavatele klientidele e-kirja enne IP-aadressi muutmist ja kavandatud hooldustöid.

• Kasutage xecd-proxy.xe.com-i ainult siis, kui vajate fikseeritud IP-aadressi. Vastasel juhul kutsuge otse xecdapi.xe.com-i.
• Kui päringud hakkavad pärast teiepoolset võrgumuudatust ebaõnnestuma, kontrollige, kas meie staatiline IP-aadress on endiselt teie tulemüüri lubatud loendis.

Kui kasutate pärandteenust Datafeed (DFS)

DFS aktsepteerib ainult lubatud loendis olevatelt IP-aadressidelt pärinevaid päringuid. Kui teie kontori või serveri IP-aadressid muutuvad, saatke meile uued aadressid. API-le üleminekul ei pea te IP-aadresse lubatud loendisse lisama.

Miks tekivad 401 või 403 vead?

• 401 Kehtetud mandaadid: kontrollige konto ID-d ja API-võtit, mille teie integratsioon saadab. Mõlemad on tõstutundlikud.
• 403 „Juurdepääsukatsete maksimaalne arv on ületatud“: pärast 3 ebaõnnestunud autentimiskatset blokeerime konto kuni 5 minutiks. Blokeering kehtib kõigile kontol olevatele integratsioonidele, sealhulgas neile, mis kasutavad õigeid mandaate. Tavaliselt tähendab see, et mõni teine süsteem, näiteks vana server või testskript, saadab endiselt aegunud võtit.

403 vea parandamiseks tehke järgmist:

1. Leidke süsteem, mis saadab vana võtit, ning uuendage seda või lülitage see välja.
2. Oodake 5 minutit ja proovige uuesti.