Kursna lista API
Sajt Kursna-Lista.info nudi za slobodno korišćenje svoj API
preko kojeg je moguće preuzimanje tekuće kursne liste, kursne liste na određeni dan
kao i korišćenje konvertora valuta. Podatke možete preuzeti u
XML,
HTML,
JSON i
PHP serialize formatu.
Za korišćenje ovog servisa potrebna je registracija koja vam omogućava
dobijanje API ID-a i pristup servisu.
Način preuzimanja podataka
Za kursnu listu na današnji dan u XML formatu
preuzmite podatake sa URL-a:
http://api.kursna-lista.info/api-id/kursna_lista/xml
gde je api-id vaš API ID, i xml format u kome želite da dobijete rezultat.
Kursna lista na dan
Kursnu listu na određeni dan možete dobiti preko:
http://api.kursna-lista.info/api-id/kl_na_dan/datum/format
gde je datum u dd.mm.gggg obliku.
Konvertor valuta
http://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:
http://api.kursna-lista.info/api-id/konvertor/eur/usd/20
Formati
format može biti xml, html, json, ili serialize. Default vrednost je json. U PHP-u preporučujemo korišćenje funkcija json_decode i unserialize
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 31.03.2020. | 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 = 'f53ec1381124cf3ac11a0ac413c7ee76'; // 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'];
}
?>