EntitioEntitio
Zurück zum Blog
API & AutomationOkt 2025 · 6 Min. Lesezeit

API-first: Warum wir keine UI-first Plattform gebaut haben

Unsere Plattform ist API-first gebaut. Das bedeutet: Jede Funktion, die in der Web-Oberflaeche verfuegbar ist, ist auch über die REST API erreichbar. Die UI ist ein Client der API -- nicht umgekehrt. Weil die UI nur ein Client ist. Das Webflow-Plugin, Batch-Skripte und zukuenftige AI-Agents sind weitere.

Warum wir uns gegen UI-first entschieden haben

Die meisten SaaS-Plattformen beginnen mit der UI und fuegen spaeter eine API hinzu. Das fuehrt zu Inkonsistenzen: Funktionen, die in der UI vorhanden sind, fehlen in der API. Wir wollten dieses Problem von Anfang an vermeiden.

REST API mit scoped Keys

Die API folgt REST-Konventionen und wird über API-Keys mit feingranularen Berechtigungen gesichert. Jeder Key kann auf bestimmte Module (DAM, Collections, KB), Operationen (read, write, admin) und Organisationen beschraenkt werden.

Jeder Nutzer, jede Integration, jeder Webhook nutzt dieselbe API

Es gibt keinen privilegierten Pfad. Was die UI kann, kann die API. Was die API nicht kann, kann die UI auch nicht. Das ist keine Einschraenkung -- es ist das Qualitaetsmerkmal.

Developer Experience

Unsere Dokumentation bietet Beispiele in cURL, JavaScript und Python. Jeder Endpoint ist beschrieben, jedes Fehlerformat ist konsistent. Pagination laeuft über Cursor, Filterung über Query-Parameter.

Die beste UI ist die, die du nicht brauchst

Wenn die API alles kann, brauchen Entwickler die UI nur noch für explorative Arbeit. Alles Wiederholbare -- Upload-Pipelines, Bulk-Updates, Synchronisationen -- laeuft über die API. Das spart Zeit und eliminiert menschliche Fehler.

Teilen

Bereit für Entitio?

Kostenlos starten
API-first: Warum wir keine UI-first Plattform gebaut haben -- Entitio Blog