Beginnen Sie mit Fehlercode und X-Request-ID. Prüfen Sie anschließend Umgebung, Projekt und dauerhaften Job-Status, bevor Sie etwas erneut senden.
Exakten Request identifizieren
Speichern Sie X-Request-ID, job_id, task_id und file_id. Damit unterscheiden Sie Transportprobleme von Engine-Fehlern und Capability-Ablehnungen.
Direkte Uploads
Bei Browser-Uploadfehlern prüfen Sie Ablauf der signierten URL, Content-Type, angekündigte Größe und Storage-CORS. Datei-Bytes dürfen nicht durch /v1/convert laufen.
Jobs und Konvertierungen
Prüfen Sie Task attempts und den maschinenlesbaren code. INVALID_CONVERSION_SETTINGS oder CONVERSION_OUTPUT_INVALID werden nicht blind wiederholt; Request oder Datei muss korrigiert werden.
Sinnvoll eskalieren
Geben Sie X-Request-ID, Umgebung, UTC-Zeit, Formatpaar und fehlerhaften Schritt an. Senden Sie niemals einen vollständigen API-Key oder sensible Datei über einen nicht freigegebenen Kanal.