Pourquoi l’URL de téléchargement PDFMonkey renvoie-t-elle une erreur 403 ?

Dernière mise à jour le 23 mars 2026

Si vous essayez d’accéder à l’URL de téléchargement d’un document et recevez une erreur 403 Forbidden, l’URL a expiré.

Pourquoi cela se produit

Les URL de téléchargement sont des liens signés temporaires valides pendant 1 heure après leur génération. Passé ce délai, l’URL cesse de fonctionner et renvoie une erreur 403. C’est un comportement normal : l’URL est conçue pour être éphémère pour des raisons de sécurité.

Chaque fois que vous récupérez les détails d’un document (via l’API, une intégration ou le Dashboard), vous recevez une nouvelle URL de téléchargement avec une nouvelle fenêtre d’1 heure. Le fichier généré reste disponible sur les serveurs de PDFMonkey jusqu’à sa suppression ; seule l’URL signée expire.

Comment corriger

Récupérez le document à nouveau pour obtenir une nouvelle URL de téléchargement. Il n’est pas nécessaire de regénérer le document.

Via l’API

Envoyez une requête GET pour récupérer le document. La réponse inclut une nouvelle download_url :

curl https://api.pdfmonkey.io/api/v1/documents/YOUR_DOCUMENT_ID \
  -H "Authorization: Bearer YOUR_SECRET_API_KEY"

Consultez la référence API Documents pour le format de réponse complet.

Via une intégration

Utilisez une action « Get Document » ou « Find Document » dans Zapier, Make, n8n, ou une autre plateforme pour rafraîchir l’URL.

Via le Dashboard

Ouvrez le document dans le Dashboard. Le lien de téléchargement affiché sur la page de détail du document est toujours à jour.

Via le SDK Ruby

Appelez document.reload! pour récupérer les attributs les plus récents, dont une download_url fraîche :

document = PdfMonkey::Document.find("YOUR_DOCUMENT_ID")
document.reload!
document.download_url  # => URL fraîche valide 1 heure

Consultez la documentation du SDK Ruby pour les instructions d’installation.

Comment éviter ce problème

  • Téléchargez immédiatement après la génération. Lorsque vous recevez une notification webhook ou interrogez l’état de complétion, téléchargez le fichier tout de suite plutôt que de stocker l’URL pour plus tard.
  • Stockez le fichier, pas l’URL. Si vous avez besoin du fichier généré ultérieurement, enregistrez-le dans votre propre stockage (S3, Google Drive, etc.) au lieu de vous fier à l’URL de téléchargement temporaire de PDFMonkey.
  • Utilisez les liens de partage pour un accès permanent. Si vous avez besoin d’une URL stable à partager par e-mail ou à intégrer dans des pages web, activez les liens de partage (disponibles sur les plans Pro+ et Premium). Contrairement aux URL de téléchargement, les liens de partage n’expirent jamais.
  • Re-récupérez si nécessaire. Si aucune des options ci-dessus ne s’applique et que vous avez besoin du fichier plus tard, récupérez à nouveau les détails du document pour obtenir une nouvelle URL. Cela ne nécessite qu’une seule requête GET.

Questions fréquentes

L’erreur 403 signifie-t-elle que mon document a été supprimé ?

Pas nécessairement. Une erreur 403 signifie que l’URL signée a expiré, pas que le fichier a disparu. Récupérez le document via l’API ; si vous obtenez une nouvelle download_url, le fichier est toujours disponible. Si le document a été supprimé (via le TTL ou manuellement), l’API renvoie une erreur 404.

Quelle est la durée exacte de validité d’une URL de téléchargement ?

Exactement 1 heure à partir du moment où l’URL est générée (lorsque vous récupérez les détails du document). Le compte à rebours ne commence pas à la création du document ni à la fin de la génération.

Cela s’applique-t-il aussi aux images ?

Oui. Les URL de téléchargement fonctionnent de la même manière quel que soit le format de sortie (PDF, PNG, JPG ou WebP). Elles expirent toutes après 1 heure.

Peut-on prolonger la durée de validité ?

Non. La durée d’1 heure est fixe et ne peut pas être configurée. Si vous avez besoin de liens plus durables, utilisez les liens de partage ou enregistrez le fichier dans votre propre stockage.

Questions fréquentes

Pourquoi l’URL de téléchargement PDFMonkey renvoie-t-elle une erreur 403 ?
Les URL de téléchargement expirent après 1 heure. Récupérez le document via l’API, une intégration ou le SDK Ruby pour obtenir une nouvelle URL avec une nouvelle fenêtre d’1 heure.
Comment obtenir une nouvelle URL de téléchargement après son expiration ?
Récupérez le document via l’API (GET /api/v1/documents/:id), via une intégration comme Zapier ou Make, ou dans le Dashboard. Chaque requête renvoie une URL fraîche valide 1 heure. Il n’est pas nécessaire de regénérer le document.
Peut-on obtenir un lien de téléchargement permanent qui n’expire jamais ?
Oui. Activez les liens de partage sur les plans Pro+ ou Premium pour obtenir une URL publique permanente pour chaque document. Contrairement aux URL de téléchargement, les liens de partage n’expirent pas.
Navigation