Häufige Probleme
Die Probleme beheben, auf die Nutzende bei CaptureKit am häufigsten stoßen.
Die meisten Support-Tickets gehen auf eine Handvoll Ursachen zurück. Arbeiten Sie diese Seite zuerst durch – das löst das Problem meist schneller, als auf eine Antwort zu warten.
| Symptom | Wahrscheinlichste Ursache | Lösung |
|---|---|---|
Jeder Aufruf gibt 401 zurück | Falscher Header-Name oder ein mit dem Secret kopiertes Leerzeichen | Der Header heißt x-api-key. Kopieren Sie das Secret erneut oder erstellen Sie einen neuen Schlüssel. |
401 Rate limit exceeded | Ein Kontingent des Schlüssels oder die Ratenbegrenzung Ihres Tarifs | Verteilen Sie den Traffic, erhöhen Sie die Limits des Schlüssels oder wechseln Sie in einen höheren Tarif. |
Aufrufe geben plötzlich 402 zurück | Guthaben aufgebraucht oder eine unbezahlte Rechnung | Kaufen Sie eine Aufladung, aktivieren Sie das automatische Aufladen oder begleichen Sie die Rechnung. |
| Timeouts nach genau 10 s oder 30 s | Ihre Plattform bricht ab, bevor wir antworten | Erhöhen Sie das Timeout Ihrer Funktion oder Ihres Clients auf 60 Sekunden. |
400 bei einer Anfrage, die früher funktionierte | Ein Pflichtparameter fehlt oder ist falsch geschrieben | Vergleichen Sie mit der Endpunkt-Seite in der API-Referenz. |
| Credits sinken schneller als erwartet | Wiederholungsversuche oder eine Schleife auf denselben Endpunkt | Prüfen Sie die Anfrageprotokolle auf wiederholt identische Aufrufe. |
| Guthaben oder Schlüssel fehlen im Dashboard | Falscher Workspace ausgewählt | Nutzen Sie den Umschalter oben in der Seitenleiste. |
| Playground verbraucht Credits unerwartet | Playground-Aufrufe sind echte API-Aufrufe | Nutzen Sie den kostenlosen Usage-Endpunkt zum Testen der Authentifizierung oder den Simulator, um Kosten ohne Traffic zu schätzen. |
402 obwohl noch Credits angezeigt werden | Eine unbezahlte Rechnung blockiert das Konto | Öffnen Sie Einstellungen → Rechnungen, begleichen Sie die Rechnung und versuchen Sie es erneut. |
Eine 60-Sekunden-Checkliste
Statuscode lesen
401 → Schlüssel oder Ratenbegrenzung. 402 → Guthaben oder Rechnung. 400 → Parameter. 5xx → mit Backoff erneut versuchen.
Die Zeile in den API-Protokollen finden
Passen Sie den Zeitstempel ab. Öffnen Sie das Detailpanel für die exakten Parameter und die Fehlermeldung.
Guthaben in der Seitenleiste prüfen
Liegt es nahe null, laden Sie auf oder aktivieren Sie das automatische Aufladen, bevor Sie eine Produktionslast erneut starten.
Immer noch blockiert
Öffnen Sie ein Support-Ticket unter Einstellungen → Support → Neues Ticket. Nennen Sie Endpunkt, Zeitstempel und den gesehenen Statuscode — mit diesen drei Angaben finden wir die Anfrage in Sekunden. API Status im selben Menü zeigt, ob das Problem bei uns liegt.