API

Čo je API?

API (Application Programming Interface) je dohodnuté rozhranie, cez ktoré môžu dva softvérové systémy medzi sebou komunikovať a vymieňať si dáta — bez toho, aby museli poznať vnútornú implementáciu druhej strany. V modernom cloudovom B2B svete sa API realizuje typicky cez REST (Representational State Transfer) alebo GraphQL nad protokolom HTTPS, s dátami vo formáte JSON.

Typická anatómia REST API volania:

• Metóda — GET (čítanie), POST (vytvorenie), PUT / PATCH (úprava), DELETE (vymazanie)
• Endpoint — URL, napr. https://api.modulario.eu/v1/invoices/12345
• Autentizácia — typicky Bearer token (OAuth 2.0) alebo API key v hlavičke
• Telo — JSON payload pri POST/PUT
• Odpoveď — HTTP status kód + JSON response

Dobre navrhnuté API má:

• Verziovanie (/v1/, /v2/) — kvôli spätnej kompatibilite
• Rate limiting — obmedzenie počtu volaní na minútu/hodinu
• Idempotencia — opakované volanie s rovnakým ID nevytvorí duplicitu
• Error handling — predvídateľné štruktúry chýb
• Pagination — pri veľkých datasetoch

V slovenskom B2B kontexte API umožňuje napríklad napojiť e-shop (WooCommerce, Shopify) na ERP — objednávka z e-shopu sa cez API automaticky vytvorí v ERP, skladové stavy sa cez API synchronizujú späť na web.

Kedy sa používa

API je dnes nevyhnutnosťou — bez otvoreného API sa moderný ERP/CRM softvér ťažko predáva, lebo nedokáže participovať v ekosystéme integrácií.

Pozri stránku API, modul Pracovné postupy a integrácie.

Súvisiace pojmy

• Webhook — push notifikácia z API. Pozri /slovnik/webhook.
• SaaS — API je štandardným rozhraním SaaS. Pozri /slovnik/saas.
• MCP — AI-friendly vrstva nad API. Pozri /slovnik/mcp.
• Workflow automation — využíva API na prepojenie systémov. Pozri /slovnik/workflow-automation.

V Modulariu

Modulario poskytuje kompletné REST API nad každým modulom — autentizácia cez OAuth 2.0 a API kľúče, rate limiting, idempotencia. Dokumentácia, príklady a Postman kolekcie na /api.

Modulario API má verejnú OpenAPI 3.1 špecifikáciu, automaticky generovaných klientov pre Python, TypeScript, PHP a Java, sandbox prostredie pre testovanie a podrobné príklady pre typické scenáre (vytvorenie faktúry, synchronizácia zákazníkov, stiahnutie reportu).