Így működik az API

Biztosan Ön is hallotta már az API kifejezést, ha máshol nem egy webalkalmazás, vagy mobilalkalmazás működése közben fellépő hibaüzenetben olvashatta már az API szót. De mit jelent az API kifejezést és mire való az API?

Az API az angol Application Programming Interface szavak rövidítése, amit magyarul úgy lehet fordítani, hogy  alkalmazásprogramozási felület.

Úgy lehet ezt elképzelni a legjobban, mint amikor elmegyünk egy étterembe. Nem fogunk a konyába bemenni és felszolgálni a saját ételünket , pláne ha még azt sem tudjuk, mit lehet ott enni.  Hiszen előbb látnunk kell az étlapot, hogy tudjuk mit lehet enni majd pedig kommunikálnunk kell a pincérrel, hogy mit szeretnénk. Ezután a pincér jelzi a rendelést a konyhán, majd az elkészített ételeket felszolgálja.

Ebben a példában a pincér az API. Az API nem más mint a kiszoláló szerver „étlapja”. Valamennyi webalkalmazás és mobil alkalmazás használ különféle API-kat. Akár a saját API-jukat, akár publikus API-kat.

Zárt API

Egy zárt API-hoz csak olyan kliensek férhetnek hozzá, akik rendelkeznek valamilyen autentikációval ahhoz, hogy elérjék az API-t és tudjonak vele kommunikálni. Például ha van egy webshop és ennek a webshopnak van egy mobilalkalmazása, akkor az biztosan API-t fog használni, hogy elérje az adatokat. De ezeket csak a webshop saját tulajdonú mobilalkalmazása érheti el, más nem.

Nyílt API

Számos nyílt API is létezik, amiket bárki felhasználhat saját szoftverkódjába. Ilyen lehet például az online fizetésért felelős PayPal vagy a Stripe API-ja, vagy akár egy online időjárás API, aminek meg tudjuk mondani, hogy Budapest időjárására vagyunk kíváncsiak:

GET /weather?city=Budapest

majd válaszol nekünk:

{
„temperature”: „26°C”,
„condition”: „sunny”
}

Ez alapján ki tudjuk írni, hogy „Ma 26°C van, és süt a nap.”

A legnépszerűbb és legelterjedtebb API típusok:

  • REST API – webes szabvány, amit JSON formátumban használunk (a legelterjedtebb)

  • SOAP API – régebbi, XML-alapú

  • GraphQL – modernebb, rugalmasabb adatlekérdezés

Így következőre, ha egy weboldalon vagy mobilalkalmazásban az aktuális árfolyamot, időjárást vagy például névnapokat fogja látni, biztos lehet benne, hogy az az oldal vagy alkalmazás egy API-t használ.