Conversion
Convertir en PDF
Transforme une URL ou du HTML en document PDF
POST/api/v1/convert/pdf
Convertit un document HTML en fichier PDF.
Vous pouvez envoyer le HTML directement, ou une URL publique que le moteur ira charger. Plusieurs options permettent d'ajuster le document : format de page, marges, zoom, orientation.
La réponse dépend du résultat : en cas de succès, vous recevez directement le fichier PDF (binaire) ; en cas d'erreur, du JSON décrivant le problème. Cliquez sur Essayer pour tester avec votre clé.
Autorisation
| Header | Description |
|---|---|
| X-API-Key | Votre clé API, à copier depuis Clés API. Voir Authentification. |
| Content-Type | application/json |
Corps de la requête
| Champ | Type | Description |
|---|---|---|
| source | string · requis | URL publique (https://…) ou HTML brut commençant par <. |
| sandbox | boolean · false | Test gratuit avec filigrane (Mode sandbox). |
| format | string · "210mmx297mm" | A3, A4, A5, Letter, Legal ou largeurxhauteur en mm, cm, in, px ou pt (ex. 100mmx150mm). |
| margin | string | number · "0" | Comme en CSS : 1 à 4 valeurs ("10mm", "10mm 5mm"…). Un nombre seul est en pixels. |
| zoom | number · 1 | Facteur d'échelle du rendu, de 0,1 à 2. |
| landscape | boolean · false | Paysage : inverse largeur et hauteur du format. |
Exemple de corps
{
"source": "https://example.com/facture/123",
"sandbox": false,
"format": "210mmx297mm",
"margin": "0",
"zoom": 1
}Réponse
200 : le PDF en binaire (application/pdf), avec les headers suivants :
| Header | Description |
|---|---|
| X-Conversion-Id | Identifiant de la conversion (visible dans les Logs). |
| X-Credits-Remaining | Crédits restants ce mois-ci. |
| X-Response-Time-Ms | Durée de la conversion en millisecondes. |
En cas d'échec, une réponse JSON { "success": false, "error": "…" } : voir Codes d'erreur.
