Pristup tečajnoj listi HNB-a
Kao besplatnu uslugu zajednici pružamo pristup tečajnoj listi HNB-a putem SmartAccounta. I to sa dostupnosti od 99,99%.
Ako ste ikada radili integraciju sa HNB v2 ili v3 API-jem primjetili ste nestandardni način formatiranja podataka, brojeve kao text, i slične probleme. A tu je naravno i problem dostupnosti. U stalnoj želji za unapređenjem SmartAccounta ali i vraćanjem zajednici od danas pružamo besplatan pristup podacima tečajne liste za USD i GBP valute, za povjesne podatke i EUR.
API je dostupan i bez SmartAccount računa.
Primjer: tečaj USD ($)
$ curl "https://app.smartaccount.hr/api/rates?currency=USD" | jq{
"data": {
"buying": 1.0824,
"middle": 1.0808,
"selling": 1.0792
},
"meta": {
"date": "2023-08-28",
"currency": "USD",
"base_currency": "EUR"
}
}Vrijednosti su tipa decimal.
Povijesni podaci
Moguće je definirati datum za pregled povijesnih podataka. Datum mora biti poslan u ISO8601 formatu.
$ curl "https://app.smartaccount.hr/api/rates?currency=USD&date=2023-05-01" | jq{
"data": {
"buying": 1.0997,
"middle": 1.0981,
"selling": 1.0965
},
"meta": {
"date": "2023-05-01",
"currency": "USD",
"base_currency": "EUR"
}
}Greška 400
API vraća grešku 400 Bad request uz objašnjenje greške.
$ curl "https://app.smartaccount.hr/api/rates" | jq{
"errors": {
"currency": [
"can't be blank"
]
}
}Validacija
| Polje | Opis |
|---|---|
| currency | Moguće vrijednosti: USD, GBP, EUR |
| date | ISO8601 format (npr. 2023-01-01), ne može biti u budućnosti |
Napomena: EUR je moguće zatražiti samo za datume prije 2023-01-01.
Dostupnost i verzioniranje
API je dostupan potpuno besplatno za integraciju u postojeće i nove sustave uz soft-limit od 10 upita po sekundi.
API se neće mijenjati, uz iznimke dodavanja novih valuta ovisno o potrebi i zahtjevima klijenata.
Za dodatna pitanja, molimo kontaktirajte nas.