Relevés et avis de paiement
Relevés périodiques et avis de paiement, générés à partir du même modèle que vos écrans de compte.
API HTML vers PDF pour des documents prêts pour la production
Générez des relevés, des rapports, des contrats et des certificats à partir du HTML et du CSS que votre application affiche déjà. Une requête en entrée, un document fini en sortie, avec le format de papier, les marges et les éléments répétés que vous définissez.
Créer un compte gratuitLire la documentation de l'API
- 100 PDF gratuits chaque mois
- Tout format de page
- Aucun frais pour les rendus échoués
- Infrastructure exploitée au Royaume-Uni
A4
Page 1 sur 3
Une seule requête
Vous avez déjà construit ce document une fois
La plupart des bibliothèques PDF vous demandent de reconstruire une mise en page déjà écrite en HTML et CSS, dans une API de dessin avec ses propres unités, polices et modèle de boîtes. Le document à l'écran et celui en pièce jointe finissent par diverger, et chaque modification coûte deux fois.
Ironfang Render imprime le balisage que vous avez déjà, dans un vrai navigateur, avec le format de papier, les marges, l'échelle, l'en-tête et le pied de page répétés définis à chaque requête. Un modèle, deux sorties, un seul endroit à modifier.
POST /render/v1/pdf
Authorization: Bearer if_live_...
Content-Type: application/json
{
"html": "<html>...your document...</html>",
"paper_format": "a4",
"print_background": true,
"margin": { "top": 0.6, "bottom": 0.8 },
"header_html": "<span></span>",
"footer_html": "<p style='font-size:9px'>Page <span class='pageNumber'></span></p>"
}
200 OK
Content-Type: application/pdfFonctionnalités
Les réglages du document, en paramètres de requête
Les réglages d'impression que vous iriez sinon chercher dans une boîte de dialogue du navigateur, définis à chaque requête et identiques à chaque fois.
Votre HTML et votre CSS
Imprimez le balisage que votre application produit déjà, ou enregistrez-le comme modèle de document et générez-le avec des données JSON vérifiées par un schéma, depuis des révisions numérotées que vous publiez et restaurez. Pas de bibliothèque de mise en page propre au PDF, pas de seconde implémentation d'un document que vous avez déjà construit.
Tout format de page, les pages utiles
A3, A4, A5, Letter, Legal et Tabloid ou un format personnalisé en millimètres ou en pouces, en portrait ou en paysage, avec des marges et un facteur d'échelle définis à chaque requête. Ne gardez que les pages que vous indiquez, et définissez le titre et l'auteur qu'affiche un lecteur PDF.
En-têtes et pieds de page répétés
Fournissez le HTML de l'en-tête et du pied de page, et il apparaît sur chaque page, là où vont les numéros de page, les logos et les références du document.
Des arrière-plans qui résistent à l'impression
Activez l'impression des arrière-plans et vos teintes, vos encadrés et vos couleurs de marque sont conservés au lieu d'être supprimés comme le fait un navigateur.
Documents derrière une connexion
Les mêmes en-têtes, en-tête Authorization et cookies qu'une requête de capture d'écran : un relevé authentifié s'imprime aussi facilement qu'une page publique.
Réponse binaire directe
Le PDF revient dans la réponse. Pas de tâche à interroger, pas de bucket à lire, sauf si vous voulez la voie asynchrone pour les longs documents.
Cas d'usage
Des documents à générer plutôt qu'à concevoir deux fois
Partout où votre application affiche déjà le contenu et où quelqu'un en a besoin sous forme de fichier.
Confirmations de commande
Joignez une confirmation imprimable à l'e-mail que votre application envoie déjà, produite par une seule requête.
Rapports et exports
Transformez un tableau de bord ou une page de rapport en un document que l'on peut classer, imprimer ou transférer.
Certificats et pass
Personnalisez pour chaque destinataire avec des variables et intégrez un QR code vérifié à la mise en page.
Contrats et courriers
Produisez des documents cohérents et à vos couleurs à partir de HTML plutôt que d'un modèle de traitement de texte dont personne ne s'occupe.
Tableaux de bord imprimables
Imprimez une vue authentifiée selon un calendrier, pour que le dossier hebdomadaire se construise tout seul.
Une requête complète, et ce qu'elle renvoie
Envoyez le HTML, ou un champ url à la place, à POST /render/v1/pdf avec votre clé API. Un succès est un 200 avec Content-Type: application/pdf et le document comme corps. Tout le reste est du JSON, {"error": {"code", "message"}} : vérifiez donc le statut avant d'enregistrer le corps comme PDF. Cette requête génère le modèle de facture du guide :
curl -sS https://api.ironfang.com/render/v1/pdf \
-H "Authorization: Bearer $IRONFANG_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @request.json \
-o invoice.pdf \
-w '%{http_code} %{content_type}\n'200 application/pdf signifie que invoice.pdf est la facture. Téléchargez request.json, le modèle HTML à partir duquel elle a été construite, ou le PDF qu'elle produit.
Ce qu'il faut savoir avant d'intégrer
- Papier : A3, A4, A5, Letter, Legal et Tabloid, en portrait ou en paysage. Sans format de papier, la page est au format Letter, et le format demandé l'emporte sur la taille
@paged'une feuille de style. - Les marges sont en pouces, pour chaque côté. Les en-têtes et pieds de page sont dessinés à l'intérieur des marges : prévoyez-leur de la place.
- Envoyer seulement un pied de page fait imprimer à Chromium son en-tête par défaut, avec la date et le titre ; envoyez
"header_html": "<span></span>"en même temps. - Les arrière-plans sont omis sauf si
print_backgroundvaut true. - Les polices sont celles du moteur de rendu : chargez-en d'autres avec
@font-facedepuis une URL publique ou une data URI. Les images et les feuilles de style doivent être accessibles depuis l'internet public. - Les sauts de page suivent le CSS :
break-inside: avoidgarde une ligne ou un bloc d'un seul tenant, et letheadd'un tableau se répète sur chaque page. - Les PDF ne sont jamais mis en cache, et les URL signées ne servent pas de PDF. Conservez les documents que vous émettez ; une tâche par lot peut les livrer dans votre propre bucket S3.
- Un rendu s'arrête au bout de 30 secondes ; un rendu échoué n'est pas compté.
Vous générez des factures ?
Une facturation demande plus qu'un seul document rendu : des milliers le premier du mois, une copie archivée qui vous appartient, et un lien de téléchargement qu'un client peut utiliser sans que votre application diffuse les octets. Tout cela a sa propre page, et le guide des factures PDF contient un modèle de facture complet, la requête qui le génère et le PDF obtenu.
Tarifs
Facturé au PDF, pas à la page
Chaque PDF compte une fois, toutes les pages jusqu'à 100 comprises ; un document plus long est refusé et n'est pas compté. Les PDF ne sont jamais mis en cache, chaque requête génère donc le document à nouveau, et un rendu échoué n'est pas compté. Chaque compte dispose d'un quota gratuit chaque mois, sans carte. Au-delà, Pay as you go facture les tarifs ci-dessous, dans la limite d'utilisation mensuelle que vous fixez. Prix hors TVA.
Chaque PDF renvoyé ou stocké, toutes les pages dans la limite de pages comprises.
Quota gratuit : 100 PDF par mois
| Unités payantes après le quota gratuit | Tarif pour 1 000 |
|---|---|
| Les 10 000 premières | 1,50 £ |
| Les 90 000 suivantes | 0,70 £ |
| Les 900 000 suivantes | 0,50 £ |
| Au-delà de 1 000 000 | 0,40 £ |
Voir les tarifs d'Ironfang RenderComparer avec d'autres fournisseurs
Questions
Avant de vous lancer
Les détails qui décident si la solution vous convient, sans lire d'abord toute la référence.
- Puis-je envoyer du HTML directement plutôt qu'une URL ?
- Oui, et c'est le cas le plus courant. Envoyez le HTML que votre application affiche déjà et il est imprimé tel quel : le document que vous voyez dans votre application est celui qui arrive sous forme de fichier.
- Quels formats de papier sont pris en charge ?
- A3, A4, A5, Letter, Legal et Tabloid, en portrait ou en paysage, avec des marges en pouces pour chaque côté et un facteur d'échelle défini à chaque requête.
- Puis-je mettre un en-tête et un pied de page sur chaque page ?
- Oui. Fournissez le HTML de l'en-tête et du pied de page et il se répète sur chaque page, là où vont habituellement les numéros de page, un logo ou une référence de document.
- Pourquoi mes couleurs d'arrière-plan manquent-elles ?
- Les navigateurs n'impriment pas les arrière-plans par défaut. Activez l'impression des arrière-plans dans la requête et vos couleurs CSS, teintes et encadrés sont conservés.
- La page doit-elle être publique ?
- Non. Une requête PDF accepte les mêmes en-têtes personnalisés, en-tête Authorization et cookies qu'une capture d'écran : un document derrière une connexion s'imprime de la même façon.
- Combien coûte un PDF ?
- Chaque PDF compte une fois sur le compteur des PDF, toutes les pages jusqu'à 100 comprises ; un document plus long est refusé et n'est pas compté. Chaque requête PDF génère le document à nouveau, un rendu échoué n'est pas compté, et une utilisation payante qui dépasserait la limite d'utilisation mensuelle que vous fixez est refusée avant de commencer. Le quota gratuit et les tarifs figurent dans la section Tarifs de cette page.
- Puis-je inclure un QR code dans le document ?
- Oui. Générez le code avec l'endpoint QR, jamais facturé, qui vérifie que le code est lisible avant de le renvoyer, puis placez-le dans votre HTML comme image. Il s'imprime avec la mise en page comme n'importe quelle autre image.
Moins à exploiter. Plus à livrer.
Générez votre premier document
Créez un compte, récupérez une clé et envoyez votre HTML existant. Chaque compte dispose de PDF gratuits chaque mois.
100 PDF gratuits chaque mois, aucune carte requise et aucun frais pour les rendus échoués.