Baza znanja

    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.

    1

    Primjer: tečaj USD ($)

    Terminal
    $ curl "https://app.smartaccount.hr/api/rates?currency=USD" | jq
    Response
    {
      "data": {
        "buying": 1.0824,
        "middle": 1.0808,
        "selling": 1.0792
      },
      "meta": {
        "date": "2023-08-28",
        "currency": "USD",
        "base_currency": "EUR"
      }
    }

    Vrijednosti su tipa decimal.

    2

    Povijesni podaci

    Moguće je definirati datum za pregled povijesnih podataka. Datum mora biti poslan u ISO8601 formatu.

    Terminal
    $ curl "https://app.smartaccount.hr/api/rates?currency=USD&date=2023-05-01" | jq
    Response
    {
      "data": {
        "buying": 1.0997,
        "middle": 1.0981,
        "selling": 1.0965
      },
      "meta": {
        "date": "2023-05-01",
        "currency": "USD",
        "base_currency": "EUR"
      }
    }
    3

    Greška 400

    API vraća grešku 400 Bad request uz objašnjenje greške.

    Terminal
    $ curl "https://app.smartaccount.hr/api/rates" | jq
    Response
    {
      "errors": {
        "currency": [
          "can't be blank"
        ]
      }
    }
    4

    Validacija

    PoljeOpis
    currencyMoguće vrijednosti: USD, GBP, EUR
    dateISO8601 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.

    5

    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.