Fehler und Wiederholungen der CloudPrint API
Behandeln Sie HTTP-Statuscodes, maschinenlesbare Fehler, Anfragelimits, Anfrageverfolgung und sichere Wiederholungslogik.
Stabile Fehlerstruktur
Fehler enthalten error, optional error_code, eine sichere message und strukturierte details. Steuern Sie Ihre Logik über maschinenlesbare Felder und den HTTP-Status.
Anfragen verfolgen
Jede Antwort enthält X-Request-Id; speichern Sie ihn zusammen mit Ihrer internen ID, print_job_id und dem Zeitstempel.
Wiederholungen
Wiederholen Sie einen 429 nach der in Retry-After angegebenen Wartezeit und temporäre 5xx mit begrenzter exponentieller Verzögerung. Korrigieren Sie Authentifizierung, Scopes, Daten oder Format, bevor Sie andere Anfragen wiederholen.
Druckfehler
Eine angenommene Anfrage kann dennoch in failed enden. Lesen Sie failure_reason und vergleichen Sie Format und Optionen mit den Druckerfunktionen.