Statuscodes
HTTP-Statuscodes der Chartquery API und deren Behandlung.
Synchrone Aufrufe werden bei 200 abgerechnet. Asynchrone Aufrufe (is_async=true) geben ein 202 zurück (nicht abgerechnet) und werden abgerechnet, wenn der Job erfolgreich abgeschlossen wurde – in Ihren Anfrage-Logs als 201 erfasst. Das Abfragen von GET /jobs/{job_id} ist immer kostenlos. Fehlgeschlagene Jobs (500) werden nie abgerechnet. Die 404-Abrechnung variiert je nach Endpunkt (siehe jeweilige Endpunkt-Seite). Alle anderen 4xx/5xx-Antworten sind kostenlos.
| Code | Abgerechnet | Status | Aktion |
|---|---|---|---|
200 | Ja | Erfolgreicher API-Aufruf (synchron) | Keine Aktion erforderlich. |
201 | Ja | Asynchroner Job abgeschlossen | Erscheint in Ihren Anfrage-Logs, wenn ein asynchroner Job erfolgreich abgeschlossen wurde – zu diesem Zeitpunkt wird der Job abgerechnet. Wird nie als HTTP-Antwort zurückgegeben. |
202 | Nein | Akzeptiert (asynchron) | Der Job wurde akzeptiert und eingereiht. Fragen Sie GET /jobs/{job_id} nach dem Ergebnis ab – das Abfragen ist immer kostenlos. |
400 | Nein | Ungültige Anfrage | Überprüfen Sie Ihre Parameter und deren Typen. Weitere Informationen finden Sie in der Dokumentation. |
401 | Nein | Ungültiger API-Schlüssel | Überprüfen Sie Ihren API-Schlüssel (x-api-key-Header oder x_api_key-Abfragestring). |
401 | Nein | Inaktiver API-Schlüssel | Aktivieren Sie Ihren API-Schlüssel im Abschnitt API-Schlüssel Ihrer Kontoeinstellungen. |
401 | Nein | Abgelaufener API-Schlüssel | Aktualisieren Sie Ihren API-Schlüssel oder generieren Sie einen neuen. |
401 | Nein | Rate limit exceeded | Warten und erneut versuchen. Plan upgraden oder schlüsselbezogene Kontingente erhöhen, wenn dies häufig vorkommt. |
402 | Nein | Payment required | Credits aufladen, Plan upgraden, Automatische Aufladung aktivieren oder offene Rechnungen begleichen. |
403 | Nein | Verboten | Überprüfen Sie Ihre Berechtigungen. Bei API Stats bedeutet HTTP 403, dass der Endpunkt auf Ihrem Konto nicht aktiviert ist: kontaktieren Sie den Support zur Aktivierung. |
404 | Variiert | Nicht gefunden | Die Abrechnung ist endpunktspezifisch. Überprüfen Sie die Dokumentation des jeweiligen Endpunkts. |
413 | Nein | Nutzlast zu groß | Die hochgeladene Datei oder der Anfragekörper überschreitet das Größenlimit. Weitere Informationen finden Sie in der Dokumentation. |
500 | Nein | Interner Fehler | Wiederholen Sie die Aktion oder kontaktieren Sie unser Support-Team. |