API

Mi az API?

Az API (Application Programming Interface) egy megállapodott interfész, amelyen keresztül két szoftverrendszer kommunikálhat és adatot cserélhet egymással — anélkül, hogy ismerniük kellene a másik oldal belső megvalósítását. A modern felhőalapú B2B világban az API tipikusan REST (Representational State Transfer) vagy GraphQL protokollon valósul meg HTTPS felett, JSON formátumú adatokkal.

Egy REST API-hívás tipikus anatómiája:

• Metódus — GET (olvasás), POST (létrehozás), PUT / PATCH (módosítás), DELETE (törlés)
• Végpont — URL, pl. https://api.modulario.eu/v1/invoices/12345
• Hitelesítés — jellemzően Bearer token (OAuth 2.0) vagy API-kulcs a fejlécben
• Törzs — JSON payload POST/PUT esetén
• Válasz — HTTP státuszkód + JSON válasz

Egy jól tervezett API rendelkezik:

• Verziózással (/v1/, /v2/) — a visszafelé kompatibilitás érdekében
• Rate limitinggel — percenkénti/óránkénti hívások korlátozása
• Idempotenciával — azonos ID-jű ismételt hívás nem hoz létre duplikációt
• Hibakezeléssel — kiszámítható hibaszerkeze
• Lapozással — nagy adathalmazok esetén

Magyar B2B kontextusban az API lehetővé teszi például egy webáruház (WooCommerce, Shopify) ERP-hez történő csatlakoztatását — az webshop rendelése API-n keresztül automatikusan létrejön az ERP-ben, a raktárkészletek API-n keresztül visszaszinkronizálódnak a webre.

Mikor alkalmazható

Az API ma nélkülözhetetlen — nyílt API nélkül egy modern ERP/CRM szoftver nehezen értékesíthető, mivel nem tud részt venni az integrációs ökoszisztémában.

Kapcsolódó fogalmak

• Webhook — push értesítés az API-ból. Lásd: /hu/szotar/webhook.
• SaaS — az API a SaaS standard interfésze. Lásd: /hu/szotar/saas.
• MCP — MI-barát réteg az API felett. Lásd: /hu/szotar/mcp.
• Workflow automation — API-t használ a rendszerek összekapcsolásához. Lásd: /hu/szotar/workflow-automation.

A Modulario-ban

A Modulario teljes REST API-t biztosít minden modulhoz — OAuth 2.0 és API-kulcsos hitelesítéssel, rate limitinggel, idempotenciával. Dokumentáció, példák és Postman gyűjtemények az /api oldalon.

A Modulario API nyilvános OpenAPI 3.1 specifikációval, automatikusan generált kliensekkel (Python, TypeScript, PHP, Java), sandbox környezettel teszteléshez és részletes példákkal rendelkezik a tipikus forgatókönyvekhez (számla létrehozása, ügyfél szinkronizálása, riport letöltése).