Ein 402 ist bewusst kein Fehler im üblichen Sinn. Er heißt, dass die Anfrage verstanden und authentifiziert wurde, das Konto aber gerade nicht den Plan oder das Guthaben dafür hat. Die Antwort enthält immer die URL zur Lösung.
Wann es passiert
- Das Guthaben ist leer, und ein Agent wollte freischalten oder exportieren.
- Die Aktion braucht einen bezahlten Plan, und das Konto hat keinen.
- Ein großer Export würde übersteigen, was das Konto bezahlen kann.
Was du tust
- Lies die URL aus der Antwort, statt eine fest einzubauen. Sie zeigt auf die richtige Lösung für dieses Konto.
- Lade das Guthaben auf der Startseite auf, oder starte einen Plan. Die Credits werden gebucht, sobald die Zahlung abgeschlossen ist.
- Wiederhole genau denselben Aufruf. Der gescheiterte Versuch hat nichts verbraucht.
Für Agenten
Die CLI endet bei einem 402 mit Code 5, bewusst getrennt vom allgemeinen Fehlercode 1. So kann ein Agent unterscheiden zwischen "dieses Konto braucht Credits" und "etwas ist kaputt" und passend reagieren: dem Menschen den Link zum Aufladen zeigen und anhalten, statt es in einer Schleife erneut zu versuchen.
Zählungen, Vorschauen, Firmenabfragen, das Anlegen von Listen, Exportstatus und Export-Downloads sind alle kostenlos, ein 402 blockiert also nie das Erkunden. Ein Agent, der einen bekommt, kann an allem weiterarbeiten außer am Ausgeben.