NBS servis
Pretraga partnera, kursna lista i podešavanja servisa.
Partner
Istorija kursa
Pokrivenost i preuzimanje traže administratorski ključ (polje gore).
NBS šalje celu listu za dan, sa svim valutama, i tako se i čuva. Preuzimaju se samo dani kojih nema u bazi.
Sačuvani kursevi
Pregled onoga što je u bazi servisa (bez upita ka NBS-u). Vikendi i praznici nemaju svoju listu.
Podešavanja
Važe odmah. Potreban je administratorski ključ (ADMIN_KLJUC iz .env), upisan u polje gore.
Automatsko preuzimanje kursa radnim danima
Termini odvojeni zarezom. Lista koja je već preuzeta se preskače.
Ključevi aplikacija (X-Api-Key)
Svaka aplikacija dobija svoj ključ. Ključ se vidi samo jednom, odmah posle pravljenja — kopiraj ga u podešavanja te aplikacije. Servis čuva samo njegov otisak, pa izgubljen ključ ne može da se pročita: napravi novi i stari opozovi.
Novi ključ za — sačuvaj ga sada, posle se više ne prikazuje:
Kako aplikacija koristi servis
- Napravi ključ za aplikaciju: kartica Podešavanja → Ključevi aplikacija. Ključ se vidi samo jednom.
- Upiši u podešavanja aplikacije (njen
.envili Infisical), ne u kod:NBS_URL= NBS_KLJUC=nbs_…ključ za tu aplikaciju…
- Zovi servis sa backend-a aplikacije, uz zaglavlje
X-Api-Key: NBS_KLJUC. Ne iz pregledača — tamo bi ključ video svako.
Pozivi
| Šta | Poziv |
|---|---|
| Kurs jedne valute | GET /v1/kurs/EUR?kurs=srednji&datum=2026-10-07 |
| Cela lista (ili samo neke valute) | GET /v1/kurs?kurs=prodajni&valute=EUR,USD |
| Kursevi za period | GET /v1/kurs/pregled?valute=EUR&od=2026-09-01&do=2026-09-30 |
| Pretraga partnera | GET /v1/partneri/pretraga?q=telekom (PIB, MB ili deo naziva, bar 3 slova) |
| Partner po PIB-u | GET /v1/partneri/100002887 (?osvezi=true = odmah sa NBS-a) |
| Partner po matičnom broju | GET /v1/partneri/mb/17162543 |
kurs: srednji (podrazumevano), kupovni ili prodajni — izabrani je u polju vrednost, a uz njega stižu sva tri.
datum: bez njega danas; za vikend i praznik stiže poslednja važeća lista (datum_liste).
tip (opciono): srednji, devize ili efektiva (gotovina) — bez njega srednji kurs je sa liste srednjeg kursa, a kupovni i prodajni sa liste za devize.
Kurs je za jedinica valute (npr. JPY 100).
Partner: naziv, skraceni_naziv, nazivi (svi oblici iz banaka), pib, maticni_broj, adresa, mesto, opstina, sifra_delatnosti, delatnost i racuni (svaki sa racun, banka, vrsta, status, aktivan, blokiran…). zastarelo: true znači da NBS trenutno ne radi i da je vraćen poslednji sačuvan podatak.
Primeri
Odgovori sa greškom
400 | loš upit (npr. neispravan PIB, budući datum) — tekst je u detail |
401 | nedostaje ili je pogrešan/opozvan ključ |
404 | nema partnera ili valute |
502 / 503 | NBS je odbio zahtev / NBS ne radi — pokušati kasnije |
Sva polja i probni pozivi: /docs.