API REST · Incluse dans toutes les offres payantes

Convertissez vos DOCX en PDF depuis votre code

Découvrez comment intégrer l'API HelloDocxToPdf à votre application.

Démarrage rapide

Convertissez un fichier DOCX en PDF en un seul appel. Transmettez votre clé d'API dans l'en-tête Authorization.

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

Authentification

Toutes les requêtes doivent être authentifiées par une clé d'API. Transmettez-la dans l'en-tête Authorization :

Authorization: Bearer hpdf_your_api_key

Astuce : Vous pouvez créer et gérer vos clés d'API dans la section Identifiants.

Point d'entrée de conversion

POST/api/convert

Convertit un fichier DOCX au format PDF.

Requête

Envoyez une requête multipart/form-data contenant le fichier :

ParamètreTypeDescription
fileFileLe fichier DOCX à convertir (obligatoire)

Réponse

Renvoie le PDF converti sous forme de données binaires, accompagné des en-têtes suivants :

En-têteDescription
Content-Typeapplication/pdf
X-Credits-UsedNombre de crédits consommés
X-Credits-RemainingCrédits restants pour le mois
X-Credits-LimitQuota mensuel total de crédits

Exemples de code

JavaScript / TypeScript

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();

Python

import requests

url = "https://www.hellodocxtopdf.com/api/convert"
headers = {"Authorization": "Bearer hpdf_your_api_key"}

with open("document.docx", "rb") as f:
    files = {"file": ("document.docx", f, "application/vnd.openxmlformats-officedocument.wordprocessingml.document")}
    response = requests.post(url, headers=headers, files=files)

if response.status_code == 200:
    with open("output.pdf", "wb") as pdf:
        pdf.write(response.content)
    print("PDF saved successfully!")
else:
    print(f"Error: {response.json()}")

Node.js

const fs = require('fs');
const FormData = require('form-data');

const form = new FormData();
form.append('file', fs.createReadStream('document.docx'));

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

const buffer = await response.arrayBuffer();
fs.writeFileSync('output.pdf', Buffer.from(buffer));
console.log('PDF saved successfully!');

Gestion des erreurs

L'API renvoie les codes de statut HTTP usuels. Les erreurs sont accompagnées d'un corps JSON détaillé :

StatutDescription
200Succès — PDF renvoyé
400Requête invalide — fichier incorrect ou paramètre manquant
401Non autorisé — clé d'API absente ou invalide
429Quota dépassé — crédits insuffisants
500Erreur serveur — la conversion a échoué

Exemple de réponse en erreur

{
  "error": "Not enough credits",
  "creditsNeeded": 3,
  "creditsRemaining": 1,
  "creditsLimit": 100,
  "resetAt": "2025-02-01T00:00:00.000Z"
}

Système de crédits

Les crédits sont décomptés selon la taille du fichier :

1 crédit = 5 Mo de fichier (arrondi au supérieur)

Taille du fichierCrédits consommés
0 à 5 Mo1 crédit
5 à 10 Mo2 crédits
10 à 15 Mo3 crédits
Et ainsi de suite…arrondi(taille / 5 Mo)

Besoin d'aide ?

Pour toute question ou difficulté, écrivez-nous à support@hellodocxtopdf.com

Documentation de l'API - Conversion DOCX en PDF | HelloDocxToPdf