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.pdfAuthentification
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_keyAstuce : Vous pouvez créer et gérer vos clés d'API dans la section Identifiants.
Point d'entrée de conversion
/api/convertConvertit un fichier DOCX au format PDF.
Requête
Envoyez une requête multipart/form-data contenant le fichier :
| Paramètre | Type | Description |
|---|---|---|
file | File | Le fichier DOCX à convertir (obligatoire) |
Réponse
Renvoie le PDF converti sous forme de données binaires, accompagné des en-têtes suivants :
| En-tête | Description |
|---|---|
Content-Type | application/pdf |
X-Credits-Used | Nombre de crédits consommés |
X-Credits-Remaining | Crédits restants pour le mois |
X-Credits-Limit | Quota 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é :
| Statut | Description |
|---|---|
200 | Succès — PDF renvoyé |
400 | Requête invalide — fichier incorrect ou paramètre manquant |
401 | Non autorisé — clé d'API absente ou invalide |
429 | Quota dépassé — crédits insuffisants |
500 | Erreur 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 fichier | Crédits consommés |
|---|---|
| 0 à 5 Mo | 1 crédit |
| 5 à 10 Mo | 2 crédits |
| 10 à 15 Mo | 3 crédits |
| Et ainsi de suite… | arrondi(taille / 5 Mo) |
Besoin d'aide ?
Pour toute question ou difficulté, écrivez-nous à support@hellodocxtopdf.com