# URL de téléchargement : erreur 403 Forbidden


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 {#why-this-happens}

Les URL de téléchargement sont des [liens signés temporaires](../generation-de-documents/url-de-telechargement.md) 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](../generation-de-documents/conservation-et-suppression.md) ; seule l’URL signée expire.

## Comment corriger {#how-to-fix-it}

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 {#fix-api}

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

```bash
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](../api/documents.md) pour le format de réponse complet.

### Via une intégration {#fix-integration}

Utilisez une action « Get Document » ou « Find Document » dans [Zapier](../integrations/zapier.md), [Make](../integrations/make.md), [n8n](../integrations/n8n.md), ou une autre plateforme pour rafraîchir l’URL.

### Via le Dashboard {#fix-dashboard}

Ouvrez le document dans le [Dashboard](../generation-de-documents/utiliser-le-tableau-de-bord.md). Le lien de téléchargement affiché sur la page de détail du document est toujours à jour.

### Via le SDK Ruby {#fix-ruby-sdk}

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

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

Consultez la [documentation du SDK Ruby](../integrations/sdk-ruby.md) pour les instructions d’installation.

### Via le SDK Node.js {#fix-node-sdk}

Récupérez à nouveau la carte du document pour obtenir une `download_url` fraîche :

```ts
const card = await client.documentCards.get("YOUR_DOCUMENT_ID");
card.download_url; // => URL fraîche valide 1 heure
```

Consultez la [documentation du SDK Node.js](../integrations/sdk-nodejs.md) pour les instructions d’installation.

## Comment éviter ce problème {#how-to-avoid-it}

- **Téléchargez immédiatement après la génération.** Lorsque vous recevez une notification [webhook](../generation-de-documents/webhooks.md) 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](../generation-de-documents/liens-de-partage.md) (disponibles sur les plans Pro+ et Premium et pendant l’essai de 30 jours). 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 {#faq}

**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](../generation-de-documents/conservation-et-suppression.md) 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](../generation-de-documents/format-de-sortie.md) (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](../generation-de-documents/liens-de-partage.md) ou enregistrez le fichier dans votre propre stockage.

## Pages associées {#related-pages}

- [L’URL de téléchargement](../generation-de-documents/url-de-telechargement.md) — fonctionnement des URL signées temporaires et leur expiration
- [L’URL de téléchargement est vide](./l-url-de-telechargement-est-vide.md) — corriger une `download_url` nulle (problème différent de l’erreur 403)
- [Liens de partage](../generation-de-documents/liens-de-partage.md) — URL publiques permanentes qui n’expirent jamais
- [Webhooks](../generation-de-documents/webhooks.md) — être notifié dès qu’un document est prêt à télécharger
- [Rétention et suppression automatique](../generation-de-documents/conservation-et-suppression.md) — durée de conservation des fichiers avant nettoyage
- [Statuts et cycle de vie des documents](../generation-de-documents/statuts-des-documents.md) — comprendre quand `download_url` devient disponible
- [Référence API Documents](../api/documents.md) — documentation complète des endpoints et des champs


## FAQ

**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 ou pendant l’essai de 30 jours pour obtenir une URL publique permanente pour chaque document. Contrairement aux URL de téléchargement, les liens de partage n’expirent pas.
