ConverterHQDevelopers
API v1

Problemen oplossen

Diagnoseer authenticatie, uploads, Jobs, webhooks en enginefouten systematisch.

Begin met error code en X-Request-ID; controleer daarna omgeving, project en duurzame Jobstatus voordat je opnieuw probeert.

Exact request identificeren

Bewaar X-Request-ID, job_id, task_id en file_id. Daarmee onderscheid je transportproblemen van enginefouten of capability-afwijzing.

Directe uploads

Bij browseruploadfouten controleer je vervaltijd van signed URL, Content-Type, opgegeven grootte en storage-CORS. Bytes mogen niet via /v1/convert lopen.

Jobs en conversies

Bekijk Task attempts en code. Retry INVALID_CONVERSION_SETTINGS of CONVERSION_OUTPUT_INVALID niet blind; corrigeer request of bestand.

Met context escaleren

Geef X-Request-ID, omgeving, UTC-tijd, formaatpaar en mislukte stap. Stuur nooit een volledige API-key of gevoelig document via een niet-goedgekeurd kanaal.