API-Dokumentation
Öffentliche REST-API für Episodendaten von Kack & Sachgeschichten.
https://kack.li
JSON
100 REQ / 15 MIN
CORS ENABLED
Öffentliche Endpunkte
GET
/api/status
Systemstatus & Statistiken
public
▶
Gibt den aktuellen Status der Datenbank zurück: Episodenanzahl, Parse-Stand, letzter Sync.
Klicke „Ausführen" um die API live abzufragen.
GET
/api/episodes
Episodenliste mit Suche & Filter
public
▶
Paginierte Episodenliste. Unterstützt Volltextsuche sowie Filter nach Gast und Thema.
| Parameter | Typ | Beschreibung | Wert |
|---|---|---|---|
| q optional | string | Volltextsuche in Titel & Beschreibung | |
| guest optional | string | Filter nach Gastname | |
| topic optional | string | Filter nach Thema | |
| limit optional | integer | Anzahl Ergebnisse (max. 100) | |
| offset optional | integer | Offset für Paginierung |
Klicke „Ausführen" um die API live abzufragen.
GET
/api/episodes/:id
Einzelne Episode
public
▶
Gibt eine einzelne Episode mit allen Feldern zurück (inkl. Kapitel, Gäste, Themen, Film-Titel).
| Parameter | Typ | Beschreibung | Wert |
|---|---|---|---|
| :id required | integer | Episoden-ID |
Klicke „Ausführen" um die API live abzufragen.
GET
/api/guests
Alle Gäste mit Auftrittsanzahl
public
▶
Liste aller Gäste, sortiert nach Anzahl der Auftritte.
Klicke „Ausführen" um die API live abzufragen.
GET
/api/topics
Alle Themen mit Häufigkeit
public
▶
Liste aller Themen, sortiert nach Häufigkeit über alle Episoden.
Klicke „Ausführen" um die API live abzufragen.
Admin-Endpunkte (Bearer-Token erforderlich)
Wird nur lokal im Browser gespeichert und ausschließlich für Anfragen an diese API verwendet.
GET
/api/logs
Server-Logs
admin
▶
Gibt die letzten Server-Logs zurück (Sync, Parse, Cron, Boot). Max. 500 Einträge.
| Parameter | Typ | Beschreibung | Wert |
|---|---|---|---|
| event optional | string | Filter: sync, parse, parse-all, cron, boot | |
| level optional | string | Filter: info, error | |
| limit optional | integer | Anzahl Einträge (max. 500) |
Token eingeben und „Ausführen" klicken.
POST
/api/sync
RSS-Feed synchronisieren
admin
▶
Synchronisiert den RSS-Feed und fügt neue Episoden zur Datenbank hinzu. Gibt die Anzahl aller und neuer Episoden zurück.
Token eingeben und „Ausführen" klicken.
POST
/api/parse-all
Alle Episoden mit OpenAI analysieren
admin
▶
Analysiert alle noch nicht geparsten Episoden im Hintergrund (~3 req/s). Mit
?force=1 werden alle Episoden neu analysiert.| Parameter | Typ | Beschreibung | Wert |
|---|---|---|---|
| force optional | 1 | Alle Episoden neu analysieren |
Token eingeben und „Ausführen" klicken.