URL de téléchargement

Dernière mise à jour le 23 mars 2026

Lorsqu’un document atteint le statut success, la réponse de l’API inclut un champ download_url. Il s’agit d’une URL signée temporaire pointant vers le PDF ou l’image généré et stocké sur S3. Elle déclenche un téléchargement de fichier (pas un affichage dans le navigateur) et expire après 1 heure.

{
  "document": {
    "id": "a5e86d72-f5b7-43d4-a04e-8b7e08e6741c",
    "status": "success",
    "download_url": "https://pdfmonkey-production.s3.eu-west-1.amazonaws.com/...",
    "preview_url": "https://preview.pdfmonkey.io/...",
    "public_share_link": null
  }
}

Quand l’URL de téléchargement apparaît

Le champ download_url n’est renseigné que lorsque le statut du document est success. Pour tous les autres statuts (draft, pending, generating, failure), le champ renvoie null.

Si vous venez de créer un document et que l’URL est null, la raison la plus probable est que la génération n’est pas encore terminée. Consultez L’URL de téléchargement est vide pour un diagnostic complet.

Expiration de l’URL (1 heure)

Les URL de téléchargement expirent après 1 heure

Chaque URL de téléchargement est valide pendant 1 heure. Passé ce délai, le lien renvoie une erreur 403 Forbidden. C’est un comportement normal : l’URL est conçue pour être éphémère pour des raisons de sécurité. Consultez L’URL de téléchargement renvoie une erreur 403 si vous rencontrez ce problème.

Chaque fois que vous récupérez les détails du document (via l’API ou une intégration), vous recevez une URL fraîche avec une nouvelle fenêtre d’une heure. Vous n’avez jamais besoin de régénérer le document lui-même pour obtenir un lien fonctionnel.

Si vous avez besoin d’une URL permanente qui n’expire jamais, utilisez plutôt les Liens de partage.

Renouveler une URL de téléchargement expirée

Si une URL de téléchargement a expiré, récupérez le document à nouveau pour en obtenir une nouvelle :

  • Via l’API : GET /api/v1/document_cards/:id — voir la Référence API Documents
  • Via une intégration : Utilisez une action « Get Document » ou « Find Document » dans Zapier, Make ou une autre plateforme
  • Via le tableau de bord : Ouvrez la page de détail du document — le lien de téléchargement est toujours à jour

Vous n’avez pas besoin de régénérer le document. Le fichier reste sur S3 jusqu’à sa suppression — seule l’URL signée expire.

URL de téléchargement vs. autres champs d’URL

ChampUtilisationExpiration
download_urlURL signée temporaire qui télécharge le fichier généré. Renseignée uniquement au statut success.1 heure
preview_urlAffiche un aperçu du document dans le navigateur. Fonctionne même pour les brouillons. Ce n’est pas un lien de téléchargement — ne l’utilisez pas pour récupérer le fichier final. Voir Intégrer une prévisualisation.N’expire pas
public_share_linkURL publique permanente pour consulter et télécharger le fichier. Disponible uniquement sur les plans Pro+ et Premium. Voir Liens de partage.N’expire pas

Bonnes pratiques

  • Téléchargez rapidement. Lorsque vous recevez une notification webhook ou que vous interrogez l’API pour vérifier que le document est prêt, téléchargez le fichier immédiatement.
  • Stockez le fichier, pas l’URL. Si vous avez besoin du fichier plus tard, enregistrez-le dans votre propre stockage (S3, Google Drive, etc.) plutôt que de compter sur l’URL de téléchargement temporaire.
  • Récupérez à nouveau si nécessaire. Si vous avez besoin de l’URL plus tard, appelez l’API à nouveau pour en obtenir une nouvelle — cela ne prend qu’une seule requête GET.
  • Utilisez les liens de partage pour la diffusion. Si vous avez besoin d’une URL stable pour l’intégrer dans des e-mails ou des pages web, utilisez public_share_link à la place (nécessite un plan Pro+ ou Premium). Voir Liens de partage.

Dépannage

Pages associées

Questions fréquentes

Combien de temps une URL de téléchargement PDFMonkey est-elle valide ?
Chaque URL de téléchargement est un lien signé temporaire valide pendant 1 heure. Passé ce délai, elle renvoie une erreur 403 Forbidden. Récupérez le document à nouveau via l’API pour obtenir une URL fraîche — pas besoin de régénérer le document.
Pourquoi le champ download_url est-il null ?
Le champ download_url n’est renseigné que lorsque le statut du document est "success". Si le document est en statut draft, pending, generating ou failure, le champ renvoie null. Assurez-vous de définir le statut sur "pending" lors de la création du document et attendez la fin de la génération.
Comment obtenir une nouvelle URL de téléchargement après expiration ?
Récupérez le document à nouveau via l’API (GET /api/v1/document_cards/:id) ou via une intégration. Chaque appel renvoie une URL fraîche avec une nouvelle fenêtre d’une heure. Pas besoin de régénérer le document.
Navigation