Az API integráció azt jelenti, hogy két különálló szoftver közvetlenül adatot cserél egymással — egyikük lekérdezi a másikat, vagy módosítást küld neki — egy szabványosított felületen, az API-n keresztül. A „közvetlen” itt fontos: nem te töltesz le egy CSV-t és töltöd fel máshova, hanem a két rendszer gépien, real-time kommunikál. Praktikusan ez az, ami a modern üzleti szoftverek 90%-át összefűzi: a CRM-ed így beszél az e-mail-szolgáltatóddal, a webshopod a fizetési szolgáltatóval, a chatbot az OpenAI-jal.
Így is ismerheted
Magyarul API-bekötés, API-összekötés, API alapú integráció. Angolul a leggyakoribb API integration, API connector, vagy specifikusan a felhő-világban iPaaS (integration platform as a service, pl. Zapier, Make, n8n). Az „API” maga Application Programming Interface — magyarul „alkalmazásprogramozási interfész”, de a szakmában tényleg API-nak hívja mindenki. A leggyakoribb API-típusok: REST (a klasszikus), GraphQL, SOAP (a régebbi vállalati), és WebSocket (real-time).
Mire jó egy API-integráció a cégednek?
A klasszikus üzleti probléma: 5-8 különböző szoftvert használsz (CRM, számlázó, e-mail, projekt-rendszer, webshop, Slack, Excel), és az adatok manuálisan vándorolnak közöttük. Egy új ügyfél bevitele 4-5 helyre 20-30 perc. Egy hónapos időszakra ez 30-50 munkaóra, ami minden hónapban elveszik. Egy jó API-integráció ezt megszünteti: a CRM-be felviszed egyszer, és minden másik rendszerbe automatikusan átkerül.
A három tipikus megtérülési vonal: időmegtakarítás (a manuális adatbevitel megszűnik), hibahiány (a copy-paste-elgépelt mezők eltűnnek), és valós idejű adat (a sales látja, ha az ügyfél fizetett, a könyvelés látja a sales-statisztikát).
Konkrét példán: egy szolgáltató cégnél a webes ajánlatkérő űrlap, a HubSpot CRM, a Számlázz.hu, és a Slack-üzenetek integrációja. Egy új lead bejön → CRM-be kerül + automatikus üdvözlő e-mail → ha az ajánlat elfogadva, díjbekérő generálódik a Számlázz.hu-n → a sales-csapat csatornájába megy a Slack-értesítés. Az értékesítőnek 0 manuális lépés van, a folyamat 30 másodperc alatt lefut.
Milyen módon kapcsolódhatnak a rendszerek?
Három fő minta van. Az első a request-response (kérés-válasz): az A rendszer kérdez, a B rendszer válaszol. Pl. „Add meg a 12345-ös azonosítójú ügyfél adatait.” Ez a klasszikus REST API működése. A második a webhook: a B rendszer értesíti az A-t, ha valami történik. Pl. „Új vásárlás történt a webshopban, küldd át az adatait.” Ez push-elt esemény-küldés, és sokkal valós-idejűbb, mint a klasszikus polling. A harmadik a real-time WebSocket: tartós, kétirányú kapcsolat, amin folyamatosan jönnek-mennek üzenetek (pl. egy chat-szolgáltatásnál vagy egy élő dashboardon).
A legtöbb üzleti integráció request-response + webhook kombinációja. A WebSocket inkább real-time alkalmazásoknál (kollaboráció, élő adatok, játék) jön elő.
Hogyan néz ki egy API-integráció kivitelezése?
Két építési minta: az iPaaS-alapú és az egyedi fejlesztésű. Az iPaaS-szolgáltatók (Zapier, Make, n8n, Power Automate) lehetővé teszik, hogy kódolás nélkül építsd össze az integrációkat egy vizuális felületen. Olyan rendszereknél működik jól, ahol mindkét oldal támogatja az iPaaS-t (a leggyakoribb 500-2000 szoftver). Költség: 20-200 dollár / hó nagyságrend.
Az egyedi fejlesztésű integráció ott jön elő, ahol a forgalom nagy, a logika komplex, vagy az egyik rendszer nem támogatott iPaaS-en. Egy fejlesztő közvetlenül megírja a Node.js / Python / PHP kódot, ami az A rendszer API-ját és a B rendszer API-ját hívja. Bevezetési költség 200 ezer-1 millió forint, de hosszú távon olcsóbb és testreszabhatóbb.
Mit nézz meg a választás előtt?
Mielőtt belevágsz, négy kérdést érdemes feltenni:
- Milyen autentikáció kell? — API kulcs (a legegyszerűbb), OAuth 2.0 (a modern szabvány, kifinomult jogosultság-kezelés), vagy basic auth (régies, kerülendő).
- Milyen rate limit van? — pl. „1000 hívás/óra” — ez korlátozza, mennyi adatot tudsz mozgatni egy időegység alatt.
- Mennyire stabil az API? — gyakori változás? Verzionált (v1, v2)? Megszakadás esetén értesít?
- Mi a dokumentáció minősége? — egy jó API doksi 30 percen belül elindulhatsz; egy rossz API doksi több napos szívás.
Mire figyelj a bevezetésnél?
Az első buktató a hibakezelés hiánya. Az API-k esetenként le-le állnak, a hálózat is hibázik, és néha ismeretlen okból jön egy 503-as válasz. A jól megírt integráció retry-mechanizmust használ (3-szor próbálkozik exponenciálisan növekvő várakozással), circuit breaker-t épít (ha a célrendszer percek óta nem válaszol, hagyja békén), és minden sikertelen hívást naplóz.
A második a biztonság: az API kulcsok soha ne kerüljenek a forrás-kódba (Git-be, frontend kódba), csak környezeti változókba (env vars) vagy secret manager-be (AWS Secrets Manager, HashiCorp Vault). A kommunikáció mindig HTTPS-en menjen — soha HTTP-n. Ha érzékeny adat megy át (személyes információ, fizetési adatok), titkosítás végpontok között is.
A harmadik a verziókezelés. Egy év múlva az API-szolgáltató kiad egy „v2″-t, és a régi „v1″-et 6 hónap múlva kikapcsolja. Ha a kódod direktben hívja, és nincs verzió-tudatos megoldás, leáll. Az integráció elejétől gondolj erre: versioned endpoint-okat hívj, és figyeld a deprecation-bejelentéseket.
A negyedik a monitoring: minden integrációd futási státusza legyen egy dashboardon. Egy „néma” megszakadt API-hívási lánc hetekig is el tud lenni észrevétlenül, és közben fontos üzleti műveletek (számlázás, e-mail-küldés) elmaradnak.
Ha API-bekötést szeretnél a céges rendszereidre — akár két szoftver összekötését, akár egy egész workflow-rendszert AI-elemekkel —, az AI és automatizáció szolgáltatásból induljunk: feltárás, eszköz-választás (iPaaS vagy custom), és bevezetés. Egyedi szoftverhez vagy weboldali API-réteghez az egyedi weboldal-fejlesztés csapat a partner.
