Einstieg
Anbindung prüfen
Zwei Werkzeuge sagen Ihnen in Sekunden, ob die Anbindung steht: der Prüfendpunkt für die Kommandozeile und die Seite „Anbindung“ im Cockpit, die den ersten Aufruf live meldet.
Prüfendpunkt
curl https://tokenwacht.de/v1/anbindung/pruefen -H "Authorization: Bearer $TOKENWACHT_KEY" # oder mit der Proxy-Kopfzeile: curl https://tokenwacht.de/v1/anbindung/pruefen -H "X-TW-Key: $TOKENWACHT_KEY"
| Feld | Bedeutung |
|---|---|
ok | true, wenn der Schlüssel gültig und aktiv ist. Sonst HTTP 401. |
mandant, projekt, schluessel | Wem der Schlüssel gehört und wie er im Cockpit heißt. |
bereiche | Geltungsbereich des Schlüssels: alle oder eine Teilmenge von proxy, ingest, lesen. Ein Schlüssel ohne „proxy“ wird vom Proxy mit 403 abgewiesen. |
ereignisse_10min | Aufrufe des Mandanten in den letzten zehn Minuten, egal über welchen Weg. |
letztes_ereignis | Der jüngste Aufruf mit Zeitpunkt, Agent, Anbieter, Modell, Quelle und Kosten. null, solange nichts angekommen ist. |
proxy | Die vier Basis-URLs, die Sie in Ihre Clients eintragen. |
hinweis | Ein Satz zum nächsten Schritt oder zur wahrscheinlichsten Ursache, wenn noch nichts ankam. |
Cockpit · Anbindung
Die Seite zeigt Ihre Schlüssel, die Basis-URLs, fertige Codeausschnitte je Umgebung mit Ihrem Mandanten und ein Live-Feld: „Warten auf den ersten Aufruf …“. Sobald der erste Aufruf über Proxy, SDK, Hook, Erweiterung oder Ingest ankommt, springt es auf Grün und zeigt Agent, Modell, Quelle und Kosten. Das ist der Moment, in dem Tokenwacht läuft.
Was der Prüfendpunkt nicht sieht
- Ob Ihr Anbieterschlüssel stimmt. Das meldet der Anbieter selbst; der Proxy reicht seinen Fehler (401, 429, 500) unverändert an Ihren Client durch und zählt ihn als Fehler-Ereignis.
- Ob Ihr Client die Kopfzeile wirklich sendet. Ein Aufruf ohne
X-TW-Keybekommt vom Proxy sofort HTTP 401 mittokenwacht_schluessel_fehlt_oder_ungueltig, er erreicht den Anbieter nicht.
Beides sehen Sie am schnellsten mit einem einzelnen curl-Aufruf aus dem Schnellstart: Antwortet der Anbieter und erscheint der Aufruf danach im Prüfendpunkt, ist alles verdrahtet.