Betreiben
API für Fremdsysteme
Alles, was das Cockpit zeigt, gibt es auch als JSON: für Rechnungsstellung, BI-Werkzeuge, Ihren eigenen Leitstand. Authentifizierung mit einem Tokenwacht-Schlüssel (Bereich „Lesen“) als Bearer.
Verbrauch abrufen
GET https://tokenwacht.de/v1/api/verbrauch?gruppe=endkunde&von=2026-09-01&bis=2026-10-01 Authorization: Bearer tw_live_…
| Parameter | Werte |
|---|---|
gruppe | agent (Standard), endkunde, modell, tag, stunde |
von, bis | ISO-Datum oder Zeitpunkt, bis ausschließlich. Standard: letzte 30 Tage. |
{"von": "2026-09-01T00:00:00+00:00", "bis": "2026-10-01T00:00:00+00:00", "gruppe": "agent",
"zeilen": [{"schluessel": "nils-icp-research", "kosten_eur": "5.4231", "kosten_usd": "5.8947", "aufrufe": 214,
"eingabe_token": 1830210, "ausgabe_token": 40215, "cache_lese_token": 990000, "fehler": 2, "verbranntes_geld_eur": "0.0412"}]}
Weitere Lese-Endpunkte mit Schlüssel
| Endpunkt | Liefert |
|---|---|
GET /v1/laeufe?limit=50, GET /v1/laeufe/{lauf_id} | Läufe mit Schritten, Kosten, Status; Lauf-Detail mit Ereignissen. |
GET /v1/uebersicht/tag?datum=2026-09-06 | Tagesverbrauch je Projekt und Endkunde. |
GET /v1/agenten | Agentenstamm mit Budgets und Eingriffsstufe. |
GET /v1/anbindung/pruefen | Schlüsselprüfung und letztes Ereignis (siehe Anbindung prüfen). |
GET /v1/status | Öffentlicher Systemstatus ohne Schlüssel. |
Exporte (Cockpit-Sitzung)
| Endpunkt | Format |
|---|---|
GET /v1/cockpit/export/weiterbelastung?monat=2026-09&format=csv|datev | Weiterbelastung je Endkunde: CSV (Semikolon, BOM, Summenzeile) oder DATEV-Buchungsstapel EXTF 700. |
GET /v1/cockpit/endkunden/{ref}/abrechnung.pdf?monat=2026-09 | Monatsabrechnung je Endkunde als PDF im Erscheinungsbild des Mandanten. |
GET /v1/cockpit/bericht/woche, …/woche.pdf | Wochenbericht als HTML oder PDF. |
GET /v1/cockpit/pruefprotokoll?format=csv | Prüfprotokoll als CSV. |
GET /v1/cockpit/export.zip | Alle Daten des Mandanten (JSON, CSV der letzten 90 Tage). |
Alarme als Webhook
Unter Konto → Alarmkanäle nimmt „Allgemeiner Webhook (JSON)“ eine URL entgegen. Je Alarm ein POST:
{"quelle": "tokenwacht", "typ": "alarm", "titel": "Leerschleife bei nils-icp-research",
"text": "Lauf RL-0815: 4 identische Werkzeugaufrufe in Folge …", "cockpit_url": "https://tokenwacht.de/cockpit",
"zeitpunkt": "2026-09-06T10:41:07+00:00"}
OpenAPI
Die vollständige Beschreibung aller Endpunkte liegt unter /docs (Swagger) und /openapi.json.