API

Was ist eine API?

API (Application Programming Interface) ist eine vereinbarte Schnittstelle, über die zwei Softwaresysteme miteinander kommunizieren und Daten austauschen können — ohne die interne Implementierung der Gegenseite kennen zu müssen. In der modernen Cloud-basierten B2B-Welt wird eine API typischerweise über REST (Representational State Transfer) oder GraphQL über das HTTPS-Protokoll mit Daten im JSON-Format realisiert.

Typische Anatomie eines REST-API-Aufrufs:

• Methode — GET (Lesen), POST (Erstellen), PUT / PATCH (Bearbeiten), DELETE (Löschen)
• Endpoint — URL, z. B. https://api.modulario.eu/v1/invoices/12345
• Authentifizierung — typischerweise Bearer Token (OAuth 2.0) oder API-Key im Header
• Body — JSON Payload bei POST/PUT
• Antwort — HTTP-Statuscode + JSON Response

Eine gut gestaltete API besitzt:

• Versionierung (/v1/, /v2/) — für Abwärtskompatibilität
• Rate Limiting — Begrenzung der Aufrufe pro Minute/Stunde
• Idempotenz — wiederholter Aufruf mit gleicher ID erstellt keine Duplikate
• Fehlerbehandlung — vorhersehbare Fehlerstrukturen
• Paginierung — bei großen Datensätzen

Im deutschen B2B-Kontext ermöglicht eine API beispielsweise die Verbindung eines Onlineshops (WooCommerce, Shopify) mit dem ERP — eine Bestellung aus dem Shop wird über die API automatisch im ERP angelegt, Lagerbestände werden über die API zurück auf die Website synchronisiert.

Wann wird sie eingesetzt

Eine API ist heute unerlässlich — ohne offene API lässt sich modernes ERP/CRM-Software kaum verkaufen, da sie nicht am Integrations-Ökosystem teilnehmen kann.

Siehe API-Seite, Modul Arbeitsabläufe und Integrationen.

Verwandte Begriffe

• Webhook — Push-Benachrichtigung von einer API. Siehe /de/glossar/webhook.
• SaaS — API ist die Standardschnittstelle von SaaS. Siehe /de/glossar/saas.
• MCP — KI-freundliche Schicht über einer API. Siehe /de/glossar/mcp.
• Workflow Automation — nutzt APIs zur Systemvernetzung. Siehe /de/glossar/workflow-automation.

In Modulario

Modulario bietet eine vollständige REST-API für jedes Modul — Authentifizierung über OAuth 2.0 und API-Keys, Rate Limiting, Idempotenz. Dokumentation, Beispiele und Postman-Collections unter /api.

Die Modulario API verfügt über eine öffentliche OpenAPI 3.1-Spezifikation, automatisch generierte Clients für Python, TypeScript, PHP und Java, eine Sandbox-Umgebung zum Testen und detaillierte Beispiele für typische Szenarien (Rechnung erstellen, Kunden synchronisieren, Report herunterladen).