APIhívás

APIhívás olyan számítógépes interakció az alkalmazások között, amelyben egy kliens kérést küld egy API végponthoz, amelyet a szerver feldolgoz, és vissza ad adatokat vagy állapotot. Gyakori cél az erőforrások elérése vagy módosítása. A legtöbb modern API HTTP(S) felületen működik, és gyakran JSON formátumot használ.

Kérés felépítése: egy APIhívás jellemzően tartalmazza a végpont URL-jét, HTTP metódust (GET, POST, PUT, PATCH, DELETE), fejléceket és szükség esetén a törzsben küldött adatokat. A válasz tartalmazza a státuszkódot és a kívánt tartalmat, amely lehet JSON.

Szinkron és aszinkron működés: a szinkron APIhívások a hívó alkalmazást addig blokkolják, amíg a válasz megérkezik. Az aszinkron hívások a háttérben futnak, a kliens pedig értesítővel vagy webhookkal kap eredményt.

Hitelesítés és jogosultság: gyakori védelmi mechanizmusok közé tartozik az API kulcsok, OAuth 2.0, JWT tokenek, és aláírt kérések. Emellett gyakori a rate limiting és a TLS/HTTPS.

Válaszok és hibakezelés: a sikeres hívások általában 2xx státuszkóddal térnek vissza (például 200, 201 vagy 204). Hibák esetén a kliens- (4xx) vagy szerveroldali (5xx) kódok jelennek meg. Formátumként gyakran JSON vagy XML.

Gyakorlati megfontolások: verziózás, jó dokumentáció, következetes konvenciók és megfelelő hibakeresési információk növelik megbízhatóságát. Érdemes tervezni a régi végpontok kivonását és a fejlesztői élmény javítását.