Pristup tečajnoj listi HNB-a

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, GBP i JPY valute, za povjesne podatke i EUR.

API je dostupan i bez SmartAccount računa.

$ 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.

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"
  }
}

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"
    ]
  }
}

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.