Un PDF depuis l’API, sans navigateur
GET /api/v1/documents/:id.pdf met un document en pages sous forme de PDF sur le serveur, pour un script ou un travail d’intégration continue qui n’a pas de navigateur d’où imprimer. L’application, elle, continue d’utiliser « Imprimer ou enregistrer en PDF » pour cela — c’est le rendu exact du navigateur lui-même, et ceci ne le remplace pas.
GET /api/v1/documents/:id.pdf, avec une clé d’API, renvoie un PDF mis en pages d’un document enregistré. C’est fait pour le cas où il n’y a aucun navigateur : une tâche planifiée, une étape d’intégration continue qui joint un rapport à une version, un script qui envoie un résumé hebdomadaire.
Pourquoi cela existe à part de l’impression
La plupart des outils de Markdown vers PDF sont un Chrome sans tête déguisé. Cela donne un rendu exact et coûte un navigateur : plusieurs centaines de mégaoctets de dépendance, un bac à sable pour l’y tenir, un démarrage par requête, et un plafond de mémoire qu’un long document atteint avant un humain. Rien de tout cela n’entre dans une fonction serverless, et un service qui démarre discrètement un navigateur par requête est un service lent et cher pour le seul cas qui aurait pu n’être ni l’un ni l’autre.
Ici, le document est mis en pages directement — titres, paragraphes, listes, tableaux, blocs de code et filets — sans navigateur nulle part sur le chemin. Cela démarre tout de suite et se termine en quelques millisecondes.
Ce que ce n’est pas
Ce n’est pas une copie au pixel près de l’aperçu. La commande Imprimer ou enregistrer en PDF de l’application utilise toujours le rendu propre du navigateur, qui est exact, et cela n’a pas changé : si vous voulez la page telle que vous la voyez, imprimez-la. Si vous voulez un PDF depuis une machine, demandez-en un.
L’utiliser
curl -H "Authorization: Bearer tp_live_…" \
https://transformpipe.com/api/v1/documents/<id>.pdf -o report.pdf
Le même document est disponible en .docx, .html et .md en changeant l’extension : un document enregistré fait donc quatre formats sans seconde conversion.
Autres lectures : les chemins de Markdown vers le PDF et convertir des documents avec une API.