Aceste răspunsuri acoperă întrebările tehnice frecvente despre integrarea cu API-ul Currency Data. Pentru fiecare endpoint și parametru, consultați documentația API. Pentru o prezentare generală a cursurilor noastre, consultați Cum funcționează API-ul Currency Data?

În acest articol

• Ce endpoint ar trebui să folosesc pentru fiecare tip de curs?
• Cum obțin lista completă a monedelor?
• Ce perechi valutare acoperă endpointul pentru cursurile bid și ask?
• Cum gestionează API-ul monedele retrase din circulație?
• Cum obțin cursurile bid și ask de la o bancă centrală?
• De ce pare că un curs al unei bănci centrale provine din ziua precedentă?
• Pot să memorez în cache cursurile din API?
• Cum obțin cursul dintr-o zi anterioară la ora mea de blocare?
• Cum găsesc certificatul SSL pentru API?
• De ce primesc erori de expirare a conexiunii sau erori 500?
• Trebuie să permit anumite adrese IP?
• De ce primesc erori 401 sau 403?

Ce endpoint ar trebui să folosesc pentru fiecare tip de curs?

Cursurile criptomonedelor provin din cursurile noastre mid-market, așadar le solicitați prin endpointurile mid-market. Adăugați crypto=true la solicitare pentru a le include.

Cum obțin lista completă a monedelor?

Utilizați endpointul /v2/currencies. Pentru fiecare monedă, acesta afișează:

• dacă este un cod ISO 4217
• data la care a fost introdusă și, dacă este retrasă din circulație, data la care a fost retrasă
• datele de început și de sfârșit pentru cursurile noastre aferente acesteia
• moneda care a înlocuit-o și orice ancorare valutară

În mod implicit, lista include monede active și retrase din circulație. Pentru a modifica acest comportament:

• adăugați obsolete=true pentru a afișa numai monedele retrase din circulație pentru care avem date istorice
• adăugați obsolete=false pentru a înlocui monedele retrase din circulație cu moneda care le-a înlocuit

Ce perechi valutare acoperă endpointul pentru cursurile bid și ask?

Endpointul /v1/bid_ask acoperă AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK și USD.

Puteți solicita orice pereche în ambele direcții, cu excepția următoarelor perechi cu CNH (yuanul chinezesc offshore):

• CNH nu este disponibil cu BRL, DKK sau PLN, în nicio direcție.
• CNH este disponibil numai ca monedă țintă cu NOK și SEK. De exemplu, puteți solicita from=NOK&to=CNH, dar nu from=CNH&to=NOK.

Cum gestionează API-ul monedele retrase din circulație?

Uneori, monedele sunt redenumite, redenominate sau retrase din circulație. În mod implicit, API-ul răspunde în moneda utilizată în prezent, așadar, dacă solicitați un cod retras, primiți cursurile monedei care l-a înlocuit. Pentru a obține cursurile codului retras în sine, adăugați obsolete=true la solicitare.

Calculăm cursurile pentru o monedă retrasă din circulație după data retragerii acesteia pe baza ancorării sale fixe la moneda care a înlocuit-o. Astfel, păstrăm coerența istoricului pe perioade lungi, însă acestea nu sunt cursuri de piață.

Pentru mai multe detalii, inclusiv despre modul în care calculăm mediile și statisticile în cazul schimbării unei monede, consultați Cursuri istorice și monede retrase din circulație în documentația API.

Cum obțin cursurile bid și ask de la o bancă centrală?

Adăugați fields=mid,bid,ask la solicitarea /v1/central_bank_rate. Fără acest parametru, veți primi doar cursul mid.

• Veți primi cursuri bid și ask numai de la băncile centrale care le publică. 37 dintre cele 100 de bănci centrale fac acest lucru, inclusiv Banca Japoniei, Autoritatea Monetară din Hong Kong, Banca Centrală a Braziliei și Banca Thailandei. Banca Centrală Europeană, Banca Angliei și Federal Reserve Bank of New York publică numai cursuri de referință. Coloana Bid/Ask din documentația API indică băncile care le publică.
• Cursurile bid și ask sunt disponibile numai pentru cursurile curente. Dacă adăugați un date la solicitare, veți primi numai cursuri mid.
• Acestea sunt cursurile publicate de fiecare bancă centrală. Sunt diferite de propriile cursuri bid și ask ale Xe din endpointul /v1/bid_ask.

De ce pare că un curs al unei bănci centrale provine din ziua precedentă?

Dacă nu specificați o dată, /v1/central_bank_rate returnează un timestamp în UTC. Când îl convertiți la ora locală, este posibil ca acel curs să pară din ziua precedentă.

Pentru a obține data locală utilizată de bancă, adăugați use_bank_date=true la solicitare. De exemplu, pentru Banca Centrală Europeană, veți obține 2026-08-17 în loc de 2026-08-16T22:00:00Z. Această opțiune funcționează pentru răspunsurile JSON, XML și CSV.

Pot să memorez în cache cursurile din API?

Da, pentru o perioadă limitată. Memorarea în cache ajută integrarea să ruleze mai rapid și reduce numărul de solicitări pe care le efectuați. Eliminați cursurile memorate în cache după ce nu mai sunt actuale. Memorarea în cache înseamnă păstrarea temporară a cursurilor. Nu înseamnă stocarea lor permanentă.

Cum obțin cursul dintr-o zi anterioară la ora mea de blocare?

Apelați /v1/historic_rate cu date=YYYY-MM-DD și use_lock_in_time=true. Veți primi cursul așa cum era la ora zilnică de blocare a contului dumneavoastră în ziua respectivă. De exemplu, puteți folosi această opțiune pentru a obține cursul de vineri în săptămâna următoare.

Ora dumneavoastră de blocare nu afectează cursurile băncilor centrale. Acestea urmează programul de publicare propriu al fiecărei bănci.

Cum găsesc certificatul SSL pentru API?

Puteți descărca certificatul din browser, utilizând Chrome sau Edge.

În Chrome

1. Deschideți Chrome și accesați https://dfs.xe.com/dfs sau https://xecdapi.xe.com/v1.

2. Selectați pictograma cu informații despre site din stânga barei de adrese.

   

3. Selectați Conexiunea este securizată, apoi selectați Certificatul este valid.

   

4. În fereastra cu detaliile certificatului, accesați fila Detalii.

   

5. Selectați Exportați pentru a descărca certificatul în sistem.

   

În Edge

1. Accesați https://dfs.xe.com/dfs sau https://xecdapi.xe.com/v1.

2. Selectați pictograma lacătului din bara de adrese.

   

3. Selectați Conexiunea este securizată.
4. Selectați pictograma certificatului din partea dreaptă sus a ferestrei pop-up.

5. În fereastra certificatului, deschideți fila Detalii.

   

6. Selectați Exportați pentru a descărca certificatul.
   
   

De ce primesc erori de expirare a conexiunii sau erori 500?

Majoritatea erorilor intermitente de expirare a conexiunii și a erorilor 5xx își au originea în rețeaua sau gateway-ul dintre sistemul dumneavoastră și al nostru. Înainte de a ne contacta, verificați:

• Gateway-uri și middleware: dacă apelați API-ul printr-o platformă de integrare sau un gateway API, verificați mai întâi jurnalele acestuia. Erorile pe care le generează singur pot arăta ca erori ale API-ului nostru.
• DNS: nu codificați sau memorați în cache adresa noastră IP. Rezolvați xecdapi.xe.com în mod normal și respectați valorile TTL DNS, deoarece adresa IP din spatele acestuia se poate schimba.
• Expirarea conexiunilor și grupurile de conexiuni: asigurați-vă că setările clientului permit volumul dumneavoastră de solicitări. Distribuiți loturile mari în timp, în loc să le trimiteți pe toate simultan.
• TLS: clientul dumneavoastră trebuie să accepte TLS 1.2 sau o versiune ulterioară, cu suite de cifruri moderne (GCM). Stivele mai vechi, precum Java 7 sau .NET tradițional, pot oferi numai cifruri CBC, pe care le retragem. Puteți testa clientul accesând https://xecd-rates-api-test.xe.com/, care acceptă numai TLS 1.3 și TLS 1.2 cu GCM.

Dacă erorile continuă, trimiteți-ne un e-mail la data@xe.com cu ID-ul contului, endpointul și parametrii, orele UTC ale eșecurilor și răspunsul complet de eroare.

Trebuie să permit anumite adrese IP?

Nu. API-ul Currency Data nu restricționează apelanții în funcție de adresa IP. Puteți apela https://xecdapi.xe.com de la orice adresă IP publică și nu trebuie să o înregistrați la noi.

Dacă firewall-ul dumneavoastră permite traficul de ieșire numai către adrese IP fixe, utilizați endpointul nostru cu IP static, xecd-proxy.xe.com, și adăugați adresa sa IP în lista de permisiuni pentru IP-ul actual. Trimitem un e-mail tuturor celor care utilizează acest endpoint înainte ca adresa sa IP să se schimbe și înaintea lucrărilor de mentenanță planificate.

• Utilizați xecd-proxy.xe.com numai dacă aveți nevoie de un IP fix. În caz contrar, apelați direct xecdapi.xe.com.
• Dacă solicitările încep să eșueze după o modificare a rețelei de partea dumneavoastră, verificați dacă lista de permisiuni a firewall-ului include în continuare IP-ul nostru static.

Dacă utilizați Datafeed tradițional (DFS)

DFS acceptă numai solicitări de la adrese IP incluse în lista de permisiuni. Dacă adresele IP ale biroului sau serverului dumneavoastră se schimbă, trimiteți-ne noile adrese. Dacă migrați la API, nu va trebui să permiteți anumite adrese IP.

De ce primesc erori 401 sau 403?

• 401 Date de autentificare nevalide: verificați ID-ul contului și cheia API trimise de integrarea dumneavoastră. Ambele țin cont de scrierea cu majuscule și minuscule.
• 403 „s-a depășit numărul maxim de încercări de acces”: după 3 încercări de autentificare eșuate, blocăm contul timp de până la 5 minute. Blocarea se aplică tuturor integrărilor din cont, inclusiv celor care utilizează date de autentificare corecte. De obicei, aceasta înseamnă că un alt sistem, precum un server vechi sau un script de testare, trimite în continuare o cheie expirată.

Pentru a remedia o eroare 403:

1. Găsiți sistemul care trimite cheia veche și actualizați-l sau opriți-l.
2. Așteptați 5 minute, apoi încercați din nou.