ConverterHQDevelopers
API v1

Erreurs

Erreurs stables et lisibles par machine avec indication de retry et request ID.

Les erreurs suivent Problem Details et ajoutent un code ConverterHQ stable. Branchez la logique applicative sur code, jamais sur le texte humain.

Problem Details

La réponse contient statut HTTP, code, détail, retryable, paramètre éventuel et request_id pour le diagnostic.

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_..."
}

Retry

Ne réessayez automatiquement que les erreurs transitoires. Une erreur de fichier ou d’option déterministe nécessite de corriger l’entrée.

Request IDs

Conservez X-Request-ID: il relie la requête, le Job, les TaskAttempts, les événements et les livraisons webhook.