Fehler

Jeder Fehler hat dieselbe Form und einen stabilen code. Verzweigen Sie anhand des Codes - die Meldung ist für Menschen geschrieben und kann umformuliert werden.

{ "error": { "code": "invalid_key", "message": "That API key does not exist." } }

Manche Fehler enthalten neben diesen beiden zusätzliche Felder: parameter für den fehlerhaften Parameter, retry_after für die Wartezeit, limit und used für ein aufgebrauchtes Kontingent.

Alle Codes

Status	Code	Wann
400	`missing_query`	`query` war leer oder fehlte.
400	`unknown_format`	`format` ist keines der sechs.
400	`unknown_column`	`columns` nennt ein Feld, das es nicht gibt.
400	`format_not_available`	Ein flaches Format wurde angefordert, wo keine Zeilen zurückgegeben werden.
400	`per_page_too_large`	`per_page` liegt über dem Zeilenlimit Ihres Tarifs. Das Limit steht im Fehler.
400	`invalid_json`	Der POST-Body ist kein gültiges JSON.
401	`missing_key`	Kein `Authorization: Bearer`-Header.
401	`invalid_key`	Der Schlüssel gehört zu keinem Konto.
403	`plan_required`	Das Konto hat keinen kostenpflichtigen Tarif.
404	`unknown_endpoint`	Diesen Pfad gibt es nicht. Die bekannten Pfade stehen im Fehler.
405	`method_not_allowed`	Die API ist schreibgeschützt. Verwenden Sie GET oder POST mit JSON-Body.
429	`too_many_requests`	Mehr als zehn Anfragen pro Minute (API und MCP zusammen).
429	`quota_exceeded`	Das tägliche Suchkontingent ist aufgebraucht.
429	`snippet_quota_exceeded`	Das tägliche Schnipsel-Kontingent ist aufgebraucht. Suchen ohne Schnipsel funktionieren weiterhin.

Was jeweils zu tun ist

400 - Ihre Anfrage ist fehlerhaft, eine Wiederholung hilft nicht. Das Feld parameter nennt den betroffenen Parameter.
401, 403 - Ihr Schlüssel oder Ihr Tarif. Ein erneuter Versuch lohnt sich erst, wenn sich daran etwas ändert.
429 too_many_requests - warten Sie retry_after Sekunden und wiederholen Sie die Anfrage. Es wurde nichts verbraucht.
429 quota_exceeded - das Kontingent steht ab der nächsten Mitternacht UTC wieder zur Verfügung; retry_after gibt an, wie lange das noch dauert. Früher erneut zu versuchen hilft nicht.
5xx - liegt bei uns. Wiederholen Sie mit wachsendem Abstand.

Fehler und Formate

Fehler kommen als JSON zurück, oder als XML, wenn format=xml angefordert wurde. Die flachen Formate haben keine Form für einen Fehler, daher erhält eine fehlgeschlagene Anfrage mit csv eine JSON-Antwort - ein Client, der CSV liest, sollte also den Statuscode prüfen, statt anzunehmen, dass jeder Body nach Art einer 200-Antwort aus Zeilen besteht.

Die Codes abrufen, ohne diese Seite zu lesen

GET / listet alle oben genannten Codes samt Bedeutung als JSON auf. Dafür ist kein Schlüssel nötig, sodass ein Client gegen den vollständigen Satz entwickelt werden kann, ohne dass jemand einen Browser öffnet.

curl https://api.publicwww.com/

Weiter Codebeispiele