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:

<arfolyam>
  <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.

© 1901-2038 - napiarfolyam.hu | 2014-04-18 08:01:23 | Web fejlesztőknek | Windows Gadget | Tečajna lista |