ConverterHQDevelopers
API v1

Error

Error stabil yang dapat dibaca mesin dengan panduan retry dan request ID.

Error menggunakan Problem Details ditambah code ConverterHQ yang stabil. Aplikasi sebaiknya bercabang berdasarkan code, bukan teks manusia.

Problem Details

Respons mencakup HTTP status, code, detail, retryable, parameter opsional, dan request_id.

Problem Details
{
  "type": "https://converterhq.io/developers/errors/file-password-protected",
  "title": "Password protected file",
  "status": 422,
  "code": "FILE_PASSWORD_PROTECTED",
  "retryable": false,
  "request_id": "req_..."
}

Retryability

Hanya error transien yang sebaiknya di-retry otomatis. Error deterministik pada file atau opsi memerlukan perubahan input.

Request IDs

Simpan X-Request-ID karena menghubungkan request, Job, TaskAttempts, event, dan diagnosis webhook.