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.
{
"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.