Comment intégrer un aperçu de document PDFMonkey dans mon application ?

Utilisez le champ preview_url de la réponse API et placez-le dans une iframe : . La visionneuse affiche le PDF sans barre d’outils, sans contrôles et sans branding.

Quand le preview_url est-il disponible pour un document PDFMonkey ?

Le preview_url est renseigné dès la création du document, même lorsque le statut est encore draft. Contrairement au download_url, vous n’avez pas besoin d’attendre la fin de la génération.

Quelle est la différence entre preview_url et download_url dans PDFMonkey ?

preview_url est une visionneuse PDF intégrable disponible quel que soit le statut et qui n’expire pas. download_url est un lien de téléchargement signé temporaire disponible uniquement après une génération réussie et valide pendant 1 heure.

Intégrer un aperçu de document

Dernière mise à jour le 23 mars 2026

Chaque document renvoyé par l’API inclut un champ preview_url. Cette URL charge une visionneuse légère que vous pouvez intégrer dans une <iframe> pour afficher le document sans quitter votre application.

Quand est-il disponible ?

Le champ preview_url est renseigné dès la création du document — même lorsque le statut est draft. Contrairement à download_url, vous n’avez pas besoin d’attendre la fin de la génération.

Intégrer l’aperçu

Insérez l’URL dans une iframe :

<iframe src="DOCUMENT_PREVIEW_URL" width="100%" height="600"></iframe>

Ce que la visionneuse affiche

L’aperçu s’ouvre dans une visionneuse minimale qui affiche simplement le PDF. Il n’y a ni barre d’outils, ni contrôles, ni branding PDFMonkey — vos utilisateurs voient le document et rien d’autre.

Cas d’utilisation

Validation de brouillon — permettez aux parties prenantes de relire un document avant de le finaliser
Visionneuse intégrée — affichez reçus, certificats ou factures directement dans votre produit
Aperçu avant téléchargement — affichez le PDF à côté d’un bouton de téléchargement
Support interne — donnez à votre équipe un moyen rapide d’inspecter le document d’un client

Notes importantes

preview_url n’est pas une URL de téléchargement. Pour récupérer le fichier généré, utilisez download_url.
Chaque fois qu’un document est enregistré, un checksum interne est mis à jour et la preview_url change en conséquence, de sorte que les navigateurs et iframes chargent toujours la dernière version sans problème de cache.
Les modèles exposent également une preview_url — consultez la référence API pour plus de détails.

Comparaison avec les autres champs URL

Champ	Disponible quand	Utilisation	Expire
`preview_url`	Toujours (y compris `draft`)	Visionneuse PDF intégrable	Non
`download_url`	`success` uniquement	Lien de téléchargement signé temporaire	Après 1 heure
`public_share_link`	`success` (Pro+ et Premium)	URL publique permanente	Non

Voir aussi : L’URL de téléchargement — Liens de partage

Questions fréquentes

Comment intégrer un aperçu de document PDFMonkey dans mon application ?: Utilisez le champ preview_url de la réponse API et placez-le dans une iframe : <iframe src="DOCUMENT_PREVIEW_URL"></iframe>. La visionneuse affiche le PDF sans barre d’outils, sans contrôles et sans branding.
Quand le preview_url est-il disponible pour un document PDFMonkey ?: Le preview_url est renseigné dès la création du document, même lorsque le statut est encore draft. Contrairement au download_url, vous n’avez pas besoin d’attendre la fin de la génération.
Quelle est la différence entre preview_url et download_url dans PDFMonkey ?: preview_url est une visionneuse PDF intégrable disponible quel que soit le statut et qui n’expire pas. download_url est un lien de téléchargement signé temporaire disponible uniquement après une génération réussie et valide pendant 1 heure.