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

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'];
}

?>


Podrška

U slučaju problema sa koriščenjenjem API-a, ili eventualnih pitanja, pošaljite e-mail na: