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.
Bereit für Entitio?
Kostenlos starten