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

API je dostupan i bez SmartAccount računa.

Primjer: tečaj USD ($)

$ curl "https://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 i definirati datum za pregled povijesnih podataka. Datum mora biti poslan u ISO8601 formatu.

$ curl "https://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://smartaccount.hr/api/rates" | jq
{
  "errors": {
    "currency": [
      "can't be blank"
    ]
  }
}

Validirana je vrijednost polja currency gdje su moguće vrijednosti USD GBP EUR. Uz napomenu da je EUR moguće zatražiti samo za datume prije 2023-01-01.

Validirana je i vrijednost polja date gdje vrijednost ne može biti u budućnosti, te mora biti formatirano po ISO8601 standardu (npr. 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.

Podrška

API se pruža bez podrške, no zaprimamo upite na koje odgovaramo po principu best effort. Upite molimo šaljite na [email protected].