Kursna lista API
Sajt Kursna-Lista.info vam pruža slobodno korišćenje API-a
za preuzimanje tekuće kursne liste, kursne liste na određeni dan
kao i korišćenje konvertora valuta. Podatke možete preuzeti u XML, HTML i JSON
formatu.
Kursna lista se ažurira svaki radni dan u 8 časova ujutru ali su moguća vrlo retka kašnjenja ukoliko NBS ne objavi novu kursnu listu na vreme. Ukoliko je kursna lista ažurirana, vrednost polja date (datum) u odgovoru API-a će biti tekući dan. U suprotnom će datum imati vrednost prethodnog radnog dana. Takva situacija će takođe biti vikendom i državnim praznicima kada se kursna lista ne ažurira.
Ne postoji fizički limit u broju pristupa API servisu ali nije dozvoljeno učestalo preuzimanje identičnih podataka (na primer preuzimanje tekuće kursne liste prilikom svakog otvaranja stranice vašeg web sajta). Kursna lista se osvežava jednom dnevno pa je samim tim dovoljno podatke preuzeti ujutru i čuvati ih lokalno. Pristup servisu će biti onemogućen korisnicima koji ne poštuju ovo pravilo.
Za korišćenje ovog servisa potrebna je registracija koja vam omogućava
kreiranje API ID-a na stranici Moj nalog.
API se nalazi iza Cloudflare servisa pa je prilikom slanja zahteva potrebno postaviti User-Agent HTTP header (većina biblioteka/klijenata ovaj header šalje automatski).
Način preuzimanja podataka
Za kursnu listu na današnji dan u XML formatu
preuzmite podatake sa URL-a:
https://api.kursna-lista.info/api-id/kursna_lista/xml
gde je api-id vaš API ID, i xml format u kojem želite da dobijete rezultat.
Kursna lista na dan
Kursnu listu na određeni dan možete dobiti preko:
https://api.kursna-lista.info/api-id/kl_na_dan/datum/format
gde je datum u dd.mm.gggg obliku.
Konvertor valuta
https://api.kursna-lista.info/api-id/konvertor/iz-val/u-val/iznos/datum/tip/format
gde je iz-val oznaka valute iz koje se vrši konverzija, u-val oznaka valute u koju se vrši konverzija,
datum (dd.mm.gggg) označava na koji dan se vrši konvertovanje, tip kursa može biti
kup, sre, pro, ef_kup, ef_pro ali u zavisnosti od odabranih valuta neki tipovi su onemogućeni.
Default tip je sre što označava srednji kurs.
Primer konvertovanja 20 evra u dolare sa kursom na današnji dan:
https://api.kursna-lista.info/api-id/konvertor/eur/usd/20
Formati
format može biti xml, html ili json. Default vrednost je json.
Greške i statusni kodovi
Kôd | Opis | Status |
0 | - | ok |
1 | Pogrešan api-id | fail |
2 | api-id nije aktiviran | fail |
3 | api-id je onemogućen | fail |
4 | Nepravilan format datuma | fail |
5 | Ne možete izabrati datum pre 15.05.2002. i posle 06.11.2024. | fail |
6 | Valute nisu validne | fail |
7 | Tip kursa nije validan | fail |
8 | Greška u konvertovanju | fail |
Primer korišćenja u PHP programskom jeziku
<?php
// Primer korišćenja API-a za konvertovanje 20 evra u dolare
$api_id = 'xyz'; // Vaš API ID
$url = 'https://api.kursna-lista.info/'.$api_id.'/konvertor/eur/usd/20';
$content = file_get_contents($url);
if (empty($content)) {
die('Greška u preuzimanju podataka');
}
$data = json_decode($content, true);
// print_r($data);
if ($data['status'] == 'ok') {
echo "20 EUR = " . $data['result']['value'] . " USD";
} else {
echo "Došlo je do greške: " . $data['code'] . " - " . $data['msg'];
}
?>
Pomoć
Slobodno nas kontaktirajte ako imate neko pitanje ili vam je potrebna pomoć u korišćenju.