API Referenz

Die Entitio REST API ermoeglicht den programmatischen Zugriff auf alle Module. Alle Endpoints liefern JSON und erwarten JSON bei schreibenden Operationen.

Basis-URL

https://api.entitio.com/v1

Alle Endpoints sind relativ zu dieser Basis-URL.

Authentifizierung

Jeder Request benoetigt einen API-Key im Authorization-Header. API-Keys werden pro Organisation erstellt und koennen mit unterschiedlichen Berechtigungen (Lesen, Schreiben, Admin) konfiguriert werden.

curl -H "Authorization: Bearer ent_live_xxxxxx" \
     https://api.entitio.com/v1/assets

API-Keys findest du unter Einstellungen → API-Keys in deinem Dashboard.

Assets

GET/assetsAlle Assets auflisten (paginiert)

GET/assets/:idEinzelnes Asset abrufen

POST/assetsNeues Asset hochladen

PATCH/assets/:idMetadaten aktualisieren

DELETE/assets/:idAsset loeschen

Beispiel: Assets mit Tag filtern und nach Upload-Datum sortieren:

GET /assets?tag=hero-image&sort=created_at&order=desc&limit=20

Collections

GET/collectionsAlle Collections auflisten

GET/collections/:id/itemsDatensaetze einer Collection

POST/collections/:id/itemsNeuen Datensatz erstellen

PATCH/collections/:id/items/:itemIdDatensatz aktualisieren

DELETE/collections/:id/items/:itemIdDatensatz loeschen

Datensaetze koennen nach beliebigen Schema-Feldern gefiltert werden:

GET /collections/coll_abc123/items?filter[status]=active&filter[category]=Premium

Knowledge Base

GET/articlesAlle Artikel auflisten

GET/articles/:slugArtikel nach Slug abrufen

POST/articlesNeuen Artikel erstellen

PATCH/articles/:idArtikel aktualisieren

POST/articles/:id/publishArtikel publizieren

Webhooks

Entitio kann Webhooks an eine URL deiner Wahl senden, wenn bestimmte Events eintreten. Du konfigurierst Webhooks im Dashboard unter Einstellungen → Webhooks.

Unterstuetzte Events:

asset.created

asset.updated

asset.deleted

collection.item.created

collection.item.updated

article.published

Rate Limits

Die API erlaubt standardmaessig 100 Requests pro Minute und API-Key. Bei Ueberschreitung erhaeltst du einen 429 Too Many Requests Response. Der Retry-After Header gibt an, wann der naechste Request moeglich ist. Mit dem API Pro Add-On (siehe Pricing) erhoehen sich die Limits auf 1.000 Requests pro Minute.