Ezek a válaszok a Currency Data API-val való integrációval kapcsolatos gyakori technikai kérdéseket fedik le. Az egyes végpontokat és paramétereket az API-dokumentációban találja. Az árfolyamaink áttekintéséért tekintse meg a Hogyan működik a Currency Data API? című cikket.

Ebben a cikkben

• Melyik végpontot használjam az egyes árfolyamtípusokhoz?
• Hogyan kérhetem le a pénznemek teljes listáját?
• Mely devizapárokat fedi le a vételi és eladási árfolyamokat biztosító végpont?
• Hogyan kezeli az API az elavult pénznemeket?
• Hogyan kérhetek le vételi és eladási árfolyamokat egy központi banktól?
• Miért tűnik úgy, mintha egy központi banki árfolyam az előző napról származna?
• Gyorsítótárazhatom az API-ból származó árfolyamokat?
• Hogyan kérhetem le egy korábbi nap árfolyamát a rögzítési időpontomban?
• Hogyan találom meg az API SSL-tanúsítványát?
• Miért kapok időtúllépési vagy 500-as hibákat?
• Engedélyezési listára kell tennem IP-címeket?
• Miért kapok 401-es vagy 403-as hibákat?

Melyik végpontot használjam az egyes árfolyamtípusokhoz?

A kriptovaluta-árfolyamok a középárfolyamainkból származnak, ezért ezeket a középárfolyam-végpontokon keresztül kérheti le. A lekérésbe illessze be a crypto=true paramétert.

Hogyan kérhetem le a pénznemek teljes listáját?

Használja a /v2/currencies végpontot. Minden pénznemnél megjelenik:

• hogy ISO 4217-kód-e
• a bevezetésének dátuma, illetve ha elavult, a kivonásának dátuma
• az arra vonatkozó árfolyamaink kezdő- és záródátuma
• az azt felváltó pénznem, valamint az esetleges rögzítés

Alapértelmezés szerint a lista aktív és elavult pénznemeket is tartalmaz. Ennek módosítása:

• adja hozzá az obsolete=true paramétert, hogy csak azokat az elavult pénznemeket jelenítse meg, amelyekhez korábbi adatokkal rendelkezünk
• adja hozzá az obsolete=false paramétert, hogy az elavult pénznemeket az azokat felváltó pénznemmel helyettesítse

Mely devizapárokat fedi le a vételi és eladási árfolyamokat biztosító végpont?

A /v1/bid_ask végpont az AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK és USD pénznemeket fedi le.

Bármelyik párt lekérheti bármelyik irányban, kivéve a CNH-val (offshore kínai jüannal) alkotott alábbi párokat:

• A CNH nem érhető el BRL, DKK vagy PLN pénznemmel egyik irányban sem.
• A CNH csak célpénznemként érhető el NOK és SEK esetén. Például lekérheti a from=NOK&to=CNH párt, de a from=CNH&to=NOK párt nem.

Hogyan kezeli az API az elavult pénznemeket?

A pénznemeket időnként átnevezik, újradenominálják vagy kivonják. Alapértelmezés szerint az API a jelenleg használt pénznemben ad választ, így ha egy kivont kódot kér le, az azt felváltó pénznem árfolyamait kapja meg. Ha magának a kivont kódnak az árfolyamaira van szüksége, adja hozzá az obsolete=true paramétert a lekéréshez.

Egy elavult pénznem kivonási dátuma utáni árfolyamait az azt felváltó pénznemhez való rögzített árfolyamából számítjuk ki. Ez egységessé teszi a hosszú előzményeket, ezek azonban nem piaci árfolyamok.

További részletekért, többek között arról, hogyan számítjuk ki az átlagokat és a statisztikákat pénznemváltás esetén, tekintse meg az API-dokumentáció Korábbi árfolyamok és elavult pénznemek című részét.

Hogyan kérhetek le vételi és eladási árfolyamokat egy központi banktól?

Adja hozzá a fields=mid,bid,ask paramétert a /v1/central_bank_rate lekéréséhez. Enélkül csak a középárfolyamot kapja meg.

• Csak azoktól a központi bankoktól kap vételi és eladási árfolyamokat, amelyek közzéteszik ezeket. A 100 központi bank közül 37 teszi ezt, köztük a Bank of Japan, a Hong Kong Monetary Authority, a Brazil Központi Bank és a Bank of Thailand. Az Európai Központi Bank, a Bank of England és a Federal Reserve Bank of New York csak referenciaárfolyamokat tesz közzé. Az API-dokumentáció Bid/Ask oszlopa mutatja, mely bankok teszik közzé ezeket.
• A vételi és eladási árfolyamok csak aktuális árfolyamokhoz érhetők el. Ha date paramétert ad a lekéréshez, csak középárfolyamokat kap.
• Ezek az egyes központi bankok által közzétett árfolyamok. Különböznek az Xe saját, a /v1/bid_ask végpontból származó vételi és eladási árfolyamaitól.

Miért tűnik úgy, mintha egy központi banki árfolyam az előző napról származna?

Ha nem ad meg dátumot, a /v1/central_bank_rate UTC szerinti timestamp értéket ad vissza. Amikor ezt a helyi időre konvertálja, az árfolyam úgy tűnhet, mintha az előző napról származna.

Ha inkább a bank saját helyi dátumát szeretné megkapni, adja hozzá a use_bank_date=true paramétert a lekéréshez. Az Európai Központi Bank esetében például a 2026-08-16T22:00:00Z helyett a 2026-08-17 értéket kapná. Ez JSON-, XML- és CSV-válaszok esetén is működik.

Gyorsítótárazhatom az API-ból származó árfolyamokat?

Igen, korlátozott ideig. A gyorsítótárazás gyorsítja az integráció működését, és csökkenti a kérések számát. Törölje a gyorsítótárazott árfolyamokat, amint elavulnak. A gyorsítótárazás az árfolyamok ideiglenes megőrzését jelenti. Nem jelenti azok végleges tárolását.

Hogyan kérhetem le egy korábbi nap árfolyamát a rögzítési időpontomban?

Hívja meg a /v1/historic_rate végpontot a date=YYYY-MM-DD és a use_lock_in_time=true paraméterekkel. Az adott napon a fiókjához tartozó napi rögzítési időpontban érvényes árfolyamot kapja meg. Ezzel például lekérheti a pénteki árfolyamot a következő héten.

A rögzítési időpontja nincs hatással a központi banki árfolyamokra. Ezek az egyes bankok saját közzétételi ütemezését követik.

Hogyan találom meg az API SSL-tanúsítványát?

A tanúsítványt a böngészőjéből töltheti le Chrome vagy Edge használatával.

Chrome-ban

1. Nyissa meg a Chrome-ot, és lépjen a következő címek egyikére: https://dfs.xe.com/dfs vagy https://xecdapi.xe.com/v1.

2. Válassza ki a webhelyinformációs ikont a címsáv bal oldalán.

   

3. Válassza a A kapcsolat biztonságos lehetőséget, majd válassza a A tanúsítvány érvényes lehetőséget.

   

4. A tanúsítvány részleteit megjelenítő ablakban lépjen a Részletek lapra.

   

5. Válassza az Exportálás lehetőséget a tanúsítvány rendszerére történő letöltéséhez.

   

Edge-ben

1. Lépjen a következő címek egyikére: https://dfs.xe.com/dfs vagy https://xecdapi.xe.com/v1.

2. Válassza ki a lakat ikont a címsávban.

   

3. Válassza a A kapcsolat biztonságos lehetőséget.
4. Válassza ki a tanúsítvány ikonját az előugró ablak jobb felső sarkában.

5. A tanúsítványablakban nyissa meg a Részletek lapot.

   

6. Válassza az Exportálás lehetőséget a tanúsítvány letöltéséhez.
   
   

Miért kapok időtúllépési vagy 500-as hibákat?

A legtöbb időszakos időtúllépés és 5xx-es hiba a hálózaton vagy az Ön rendszere és a mi rendszerünk közötti átjárónál keletkezik. Mielőtt kapcsolatba lépne velünk, ellenőrizze a következőket:

• Átjárók és köztes rétegek: ha egy integrációs platformon vagy API-átjárón keresztül hívja az API-t, először annak naplóit ellenőrizze. Az általa létrehozott hibák úgy tűnhetnek, mintha az API-nktól származnának.
• DNS: ne kódolja be rögzítetten és ne gyorsítótárazza az IP-címünket. A xecdapi.xe.com címet a szokásos módon oldja fel, és tartsa be a DNS TTL-értékeit, mivel a mögötte lévő IP-cím megváltozhat.
• Időtúllépések és kapcsolatkészletek: győződjön meg arról, hogy az ügyfél beállításai lehetővé teszik a kérések kívánt mennyiségét. A nagy kötegelt kéréseket ossza el, ahelyett hogy egyszerre küldené el őket.
• TLS: az ügyfélnek támogatnia kell a TLS 1.2-es vagy újabb verzióját modern (GCM) titkosítási csomagokkal. A régebbi rendszerek, például a Java 7 vagy a régi .NET, csak CBC-titkosításokat kínálhatnak, amelyeket fokozatosan kivezetünk. Ügyfelét a https://xecd-rates-api-test.xe.com/ címen tesztelheti, amely csak a TLS 1.3-at, valamint a GCM-mel használt TLS 1.2-t fogadja el.

Ha a hibák továbbra is fennállnak, írjon nekünk a data@xe.com címre, és adja meg fiókazonosítóját, a végpontot és a paramétereket, a hibák UTC szerinti időpontját, valamint a teljes hibaüzenetet.

Engedélyezési listára kell tennem IP-címeket?

Nem. A Currency Data API nem korlátozza a hívókat IP-cím alapján. A https://xecdapi.xe.com címet bármely nyilvános IP-címről hívhatja, és nem kell regisztrálnia nálunk a sajátját.

Ha a tűzfala csak rögzített IP-címekre engedélyezi a kimenő forgalmat, használja statikus IP-címet biztosító végpontunkat, a xecd-proxy.xe.com címet, és adja hozzá annak IP-címét az engedélyezési listához. az aktuális IP-címért. Az ezen végpontot használóknak e-mailt küldünk az IP-cím megváltozása és a tervezett karbantartás előtt.

• Csak akkor használja a xecd-proxy.xe.com címet, ha rögzített IP-címre van szüksége. Ellenkező esetben közvetlenül a xecdapi.xe.com címet hívja.
• Ha a kérések az Ön oldalán történt hálózati változás után kezdenek sikertelenül lefutni, ellenőrizze, hogy a tűzfal engedélyezési listája továbbra is tartalmazza-e a statikus IP-címünket.

Ha a régi Datafeedet (DFS) használja

A DFS csak az engedélyezési listán szereplő IP-címekről érkező kéréseket fogadja el. Ha az irodai vagy szerver-IP-címei megváltoznak, küldje el nekünk az újakat. Ha áttér az API-ra, nem lesz szüksége IP-címek engedélyezési listára helyezésére.

Miért kapok 401-es vagy 403-as hibákat?

• 401 Érvénytelen hitelesítő adatok: ellenőrizze az integráció által küldött fiókazonosítót és API-kulcsot. Mindkettő megkülönbözteti a kis- és nagybetűket.
• 403 „túllépte a hozzáférési kísérletek maximális számát”: 3 sikertelen hitelesítési kísérlet után legfeljebb 5 percre zároljuk a fiókot. A zárolás a fiók minden integrációjára vonatkozik, beleértve a helyes hitelesítő adatokat használókat is. Ez általában azt jelenti, hogy egy másik rendszer, például egy régi szerver vagy tesztszkript, továbbra is egy elavult kulcsot küld.

403-as hiba kijavítása:

1. Keresse meg az elavult kulcsot küldő rendszert, majd frissítse vagy kapcsolja ki.
2. Várjon 5 percet, majd próbálkozzon újra.