API DOCX en PDF pour votre application

L'API expose un seul point d'entrée : POST /api/convert. Vous envoyez le DOCX en multipart/form-data dans un champ nommé file, avec votre clé d'API dans l'en-tête Authorization. La réponse est le PDF lui-même, en données binaires avec Content-Type : application/pdf : vous pouvez l'écrire sur disque, le transmettre à votre utilisateur ou le stocker où vous voulez.

Trois en-têtes de réponse vous indiquent où vous en êtes : X-Credits-Used (crédits consommés par cet appel), X-Credits-Remaining (crédits restants ce mois-ci) et X-Credits-Limit (votre quota mensuel). La conversion est la même que celle du convertisseur en ligne : la mise en page du document Word est conservée.

Une première conversion depuis la ligne de commande :

curl -X POST https://www.hellodocxtopdf.com/api/convert \
  -H "Authorization: Bearer hpdf_your_api_key" \
  -F "file=@document.docx" \
  -o output.pdf

Chaque requête doit porter une clé d'API dans l'en-tête Authorization, sous forme de jeton Bearer. Les clés se créent et se gèrent dans la section Identifiants de votre tableau de bord, une fois une offre souscrite. Une requête sans clé valide reçoit une réponse 401.

Authorization: Bearer hpdf_your_api_key

La consommation se compte en crédits : 1 crédit par tranche de 5 Mo de fichier, arrondie au supérieur. Un document de 3 Mo coûte 1 crédit, un document de 8 Mo 2 crédits, un document de 13 Mo 3 crédits. Les crédits se renouvellent chaque mois et les crédits non utilisés ne sont pas reportés.

Quand les crédits sont épuisés, l'API répond 429 avec un corps JSON indiquant creditsNeeded, creditsRemaining, creditsLimit et resetAt, pour que votre intégration puisse attendre ou changer d'offre. Le détail de chaque offre figure sur la page des tarifs.

const formData = new FormData();
formData.append('file', docxFile);

const response = await fetch('https://www.hellodocxtopdf.com/api/convert', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer hpdf_your_api_key'
  },
  body: formData
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.message);
}

const pdfBlob = await response.blob();
const pdfUrl = URL.createObjectURL(pdfBlob);

// Download the PDF
const link = document.createElement('a');
link.href = pdfUrl;
link.download = 'document.pdf';
link.click();

Les exemples Python et Node.js, la liste des codes de statut et le format des erreurs sont dans la documentation complète de l'API.