Documents · API HTML vers PDF
Votre HTML devient un PDF avec la qualité d’un navigateur.
Envoyez HTML et CSS et recevez des PDF, PNG ou JPG rendus par un vrai Chromium. Générez factures, rapports et certificats un par un ou en lots avec template, sans maintenir de serveurs de rendu.
curl -X POST 'https://api.respawntech.dev/v1/tools/document/pdf/convert' \
-H "X-API-Token: $RESPAWN_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"html": "<h1>Fatura #001</h1><p>Total: R$ 199,90</p>",
"format": "pdf",
"page_size": "A4",
"webhook_url": "https://seu-app.com/webhooks/pdf"
}'Cas d’usage
Convertissez HTML et CSS en PDF, PNG ou JPG — un document ou 500 d’un coup.
Factures, reçus et bordereaux de paiement
Transformez le HTML que vous avez déjà en documents prêts à envoyer au client.
Rapports avec graphiques
Activez JavaScript pour rendre graphiques et SPA avant de générer le PDF.
Certificats et contrats en masse
Un template, jusqu’à 500 variantes par lot, avec remise sur volume.
Comment ça marche
De l’inscription au premier appel en quelques minutes
Envoyez le HTML
POST avec HTML, CSS et options ; recevez le conversion_id avec le statut 202.
Attendez le webhook
Votre endpoint est appelé quand le job est terminé — sans polling.
Téléchargez le fichier
Téléchargez le PDF (ou le ZIP du lot) via l’endpoint de téléchargement.
Fonctionnalités
Conçue pour la production
Rendu fidèle
Chromium headless compatible CSS moderne et Google Fonts, avec en-tête et pied de page sur chaque page.
PDF, PNG ou JPG
Choisissez le format, la taille de page (A4, Letter, Legal), l’orientation, les marges et l’échelle.
Lots avec template
Envoyez un template avec placeholders et jusqu’à 500 éléments ; téléchargez le tout dans un ZIP.
Vraiment asynchrone
Recevez un 202 immédiatement et soyez prévenu par webhook quand le fichier est prêt.
JavaScript en sandbox
Activez enable_js pour les pages qui dépendent de scripts, avec attente d’un sélecteur ou d’un délai.
Rétention maîtrisée
Fichiers éphémères pendant ~24 h, rétention jusqu’à 30 jours ou permanente, stockés de manière chiffrée.
Tarifs
Payez à l’usage, pas à l’abonnement
Chaque document coûte à partir de 1 crédit. La rétention au-delà de 3 jours et JavaScript sont en option, et les lots à partir de 10 éléments bénéficient d’une remise automatique.
HTML vers PDF — par document
| Élément | Crédits |
|---|---|
| Conversion de base | 1,0 |
Rétention jusqu’à 3 joursretention_days ≤ 3 | +0,0 |
Rétention de 4 à 7 joursretention_days 4–7 | +0,5 |
Rétention de 8 à 30 joursretention_days 8–30 | +2,5 |
Rétention permanenteretention_days: -1 | +15,0 |
JavaScript en sandboxenable_js | +0,25 |
HTML vers PDF — remise sur les lots
| À partir de | Remise |
|---|---|
| 10+ | 5% |
| 20+ | 10% |
| 30+ | 15% |
| 40+ | 20% |
Lectures via l’API (au-delà du quota quotidien)
Montants par requête, facturés uniquement après les lectures gratuites du jour.
| Opération | Crédits |
|---|---|
| Lister les conversions ou lots | 0,005 |
| Statut d’une conversion ou d’un lot | 0,01 |
| Téléchargement de fichier ou de ZIP | 0,03 |
Cas d’usage
Ce que vous pouvez construire
FAQ
Questions fréquentes
Combien de temps prend une conversion ?
Les documents simples sont généralement prêts en quelques secondes. Le traitement étant asynchrone, utilisez webhook_url pour être prévenu sans avoir à interroger le statut.
Puis-je utiliser des polices et des images externes ?
Oui. Utilisez google_fonts_url pour les polices Google et des URL absolues pour les images et les feuilles de style.
Combien de temps le fichier reste-t-il disponible ?
Par défaut, jusqu’à 3 jours sans surcoût. Vous pouvez choisir une rétention éphémère (~24 h), jusqu’à 30 jours ou permanente.
Et si la conversion échoue ?
Le statut indique la raison dans error_code. Vous pouvez relancer la conversion ; les échecs ne produisent pas de fichier à télécharger.
Commencez à intégrer dès aujourd’hui
Créez votre compte, générez un token et lancez votre premier appel en quelques minutes.