Napiárfolyam.hu API 1.0 - lekérdezhető árfolyamok
Új verzió!
A Béta verzió óta az XML fában is történt változás - a egyszerűbb feldolgozhatóság érdekében, ezért a Béta verzió támogatása megszünt, de a továbbiakban is elérhető a http://betapi.napiarfolyam.hu címen, a leírása ide költözött: http://www.napiarfolyam.hu/betapi. A jővőben probáljuk az ilyen fajta változtatásokat elkerülni. Megértéseteket köszönjük.
Újdonságok: egyben lekérdezhető aktuális árfolyamok, időszakra lekérdezhető archív árfolyamok, egységes adatszerkezet, könnyebb feldolgozhatóság
A napiarfolyam.hu API, egy XML alapú kommunikációs csatorna, amelyben a napiarfolyam.hu árfolyamai lekérdezhetőek. Az API a http://api.napiarfolyam.hu URL-en érhető el, és GET methódussal paraméterezhető. Paraméterezés nélkül az összes bank aktuális árfolyama a visszatérési értéke: http://api.napiarfolyam.hu
Paraméretek:
bank
A bank-ban átadott pénzintézet összes árfolyama. (datum megadása nélkül az aktuális árfolyamokat adja vissza)
Lehetséges értékek: bb, allianz, cib, citibank, commerz, erste, kdb, kh, mkb, oberbank, otp, raiffeisen, unicredit, volksbank, mnb, sopron, mfb, fhb
Példa: http://api.napiarfolyam.hu?bank=kh
valuta
A valuta-ban átadott pénznem összes árfolyama. (datum megadása nélkül az aktuális árfolyamokat adja vissza)
Lehetséges értékek: GBP, AUD, DKK, JPY, CAD, NOK, CHF, SEK, USD, CZK, PLN, EUR, HRK, RON, TRY
Példa: http://api.napiarfolyam.hu?valuta=eur
Opcionális paraméterek:
Csak a bank vagy valuta paraméterek egyikkel együtt használhatóak.
datum
Archív árfolyamok a datum-ban átadott időpontban. Minden datum napon történt módosulást tartalmaz, tehát egy bank adott napi többszöri változtatásait is.
Valós érték: EEEEHHNN
Példa: http://api.napiarfolyam.hu?bank=kh&datum=20100305
datumend
Archív árfolyamok a datum-tól datumend-ig terjedő időpontban. Minden az adott időszakban történt módosulást tartalmaz Az időtáv maximum 31 nap lehet.
Valós érték: EEEEHHNN
Példa: http://api.napiarfolyam.hu?bank=kh&datum=20100305&datumend=20100307
valutanem
A devizanem (értsd: valuta/deviza) szükítése érhető el vele. Megadása hiányában, mindkét lehetséges értékkel tér vissza.
Lehetséges értékek: valuta, deviza
Példa: http://api.napiarfolyam.hu/?bank=kh&valutanem=valuta
Output:
Az API visszatérési értéke egy XML dokumentum, a következő fa struktúrával:
<valuta>
<item>
<bank>bank rövidítése</bank>
<datum>mikor kapta ezt az értéket</datum>
<penznem>pénznem kódja</penznem>
<vetel>árfolyam 1 egységre</vetel>
<eladas>árfolyam 1 egységre</eladas>
</item>
</valuta>
<deviza>
<item>
<bank>bank rövidítése</bank>
<datum>mikor kapta ezt az értéket</datum>
<penznem>pénznem kódja</penznem>
<vetel>árfolyam 1 egységre</vetel>
<eladas>árfolyam 1 egységre</eladas>
<kozep>árfolyam 1 egységre</kozep> - csak az MNB esetében
</item>
</deviza>
</arfolyam>
Megkötések
Egy órán belül egy IP címről korlátozott számú kérés indítható. A napiarfolyam.hu mindent megtesz az adatok pontossága érdekében, de pontosságukért felelősséget nem vállal.
Kérések
Az API felhasználása esetén egy Az árfolyamokat a napiárfolyam.hu gyüjti linket megköszönünk.