ConverterHQDevelopers
API v1

Sorun giderme

Kimlik doğrulama, upload, Jobs, webhooks ve engine hatalarını sistematik tanılayın.

Önce error code ve X-Request-ID ile başlayın; retry yapmadan environment, proje ve durable Job state’i kontrol edin.

İsteği tanımlayın

X-Request-ID, job_id, task_id ve file_id saklayın. Böylece transport sorunu ile engine veya capability reddini ayırabilirsiniz.

Doğrudan upload

Browser upload başarısızsa signed URL süresi, Content-Type, bildirilen boyut ve storage CORS’u kontrol edin. Dosya byte’ları /v1/convert üzerinden gitmemelidir.

Jobs ve dönüşümler

Task attempts ve code değerini inceleyin. INVALID_CONVERSION_SETTINGS veya CONVERSION_OUTPUT_INVALID için kör retry yapmayın; request veya file’ı düzeltin.

Bağlamla eskale edin

X-Request-ID, environment, UTC zamanı, format çifti ve başarısız adımı sağlayın. Tam API key veya hassas dosyayı onaysız kanalda paylaşmayın.