Entwicklung & API

Bludit API Tutorial: Seiten lesen, erstellen und sicher automatisieren

Ein Einstieg in die Bludit-API mit Endpunkten, Authentifizierung, Seitenobjekten und Sicherheitsregeln.

~1 Minute Lesezeit

Bludit bringt eine API als Plugin mit. Sie ist nützlich für externe Tools, mobile Clients, Headless-Ausgaben oder Automatisierung. Aktivieren sollte man sie aber nur, wenn ein konkreter Einsatzzweck vorhanden ist.

Was die API liefert

Die aktuelle API-Dokumentation beschreibt Seitenobjekte mit Key, UUID, Titel, Status, Content, Rohinhalt, Datum, Tags, Kategorie, Permalink und Coverbild. Listenendpunkte unterstützen Pagination; Kategorien können ebenfalls abgefragt werden.

Seitenliste abrufen

GET /api/pages?token=<api-token>

Seite erstellen

POST /api/pages
Content-Type: application/json

{
  "token": "<api-token>",
  "authentication": "<auth-token>",
  "title": "Neue Seite",
  "content": "Inhalt"
}

Sicherheitsregeln

  • API nur aktivieren, wenn sie gebraucht wird.
  • Tokens nicht in öffentliches JavaScript schreiben, wenn sie Schreibrechte ermöglichen.
  • Schreibende Clients über HTTPS betreiben.
  • Berechtigungen und Token regelmäßig rotieren, wenn ein Integrationssystem entfällt.
  • Fehlercodes sauber behandeln: 400 Validierung, 401 Authentifizierung, 404 Ressource, 500 Serverfehler.

Quellen und weiterführende Dokumentation