ConverterHQDevelopers
API v1

Fehlersuche

Authentifizierung, Uploads, Jobs, Webhooks und Engine-Fehler systematisch untersuchen.

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.