API

Czym jest API?

API (Application Programming Interface) to uzgodniony interfejs, przez który dwa systemy oprogramowania mogą komunikować się ze sobą i wymieniać dane — bez konieczności znajomości wewnętrznej implementacji drugiej strony. W nowoczesnym środowisku B2B w chmurze API realizowane jest typowo przez REST (Representational State Transfer) lub GraphQL nad protokołem HTTPS, z danymi w formacie JSON.

Typowa anatomia wywołania REST API:

• Metoda — GET (odczyt), POST (tworzenie), PUT / PATCH (modyfikacja), DELETE (usunięcie)
• Endpoint — URL, np. https://api.modulario.eu/v1/invoices/12345
• Uwierzytelnianie — typowo Bearer token (OAuth 2.0) lub klucz API w nagłówku
• Ciało — JSON payload przy POST/PUT
• Odpowiedź — kod statusu HTTP + odpowiedź JSON

Dobrze zaprojektowane API posiada:

• Wersjonowanie (/v1/, /v2/) — dla zachowania wstecznej kompatybilności
• Rate limiting — ograniczenie liczby wywołań na minutę/godzinę
• Idempotentność — powtórzone wywołanie z tym samym ID nie tworzy duplikatu
• Obsługę błędów — przewidywalne struktury błędów
• Paginację — przy dużych zbiorach danych

W polskim kontekście B2B API umożliwia np. połączenie sklepu internetowego (WooCommerce, Shopify) z ERP — zamówienie ze sklepu jest automatycznie tworzone w ERP przez API, a stany magazynowe są synchronizowane z powrotem na stronę.

Kiedy ma zastosowanie

API jest dziś niezbędnością — bez otwartego API nowoczesne oprogramowanie ERP/CRM trudno sprzedać, ponieważ nie może uczestniczyć w ekosystemie integracji.

Zob. stronę API, moduł Procesy robocze i integracje.

Powiązane pojęcia

• Webhook — powiadomienie push z API. Zob. /pl/slownik/webhook.
• SaaS — API jest standardowym interfejsem SaaS. Zob. /pl/slownik/saas.
• MCP — warstwa przyjazna dla AI nad API. Zob. /pl/slownik/mcp.
• Workflow automation — wykorzystuje API do łączenia systemów. Zob. /pl/slownik/workflow-automation.

W Modulario

Modulario udostępnia kompletne REST API dla każdego modułu — uwierzytelnianie przez OAuth 2.0 i klucze API, rate limiting, idempotentność. Dokumentacja, przykłady i kolekcje Postman dostępne na /api.

Modulario API posiada publiczną specyfikację OpenAPI 3.1, automatycznie generowanych klientów dla Pythona, TypeScriptu, PHP i Javy, środowisko sandbox do testowania oraz szczegółowe przykłady dla typowych scenariuszy (tworzenie faktury, synchronizacja klientów, pobieranie raportu).