Liens de partage permanents pour les documents générés

Chaque document généré avec succès sur un plan Pro+ ou Premium inclut un champ public_share_link : une URL publique permanente qui n’expire jamais et ne nécessite aucune authentification. Utilisez-la pour partager des fichiers générés par email, les intégrer dans des pages web ou les distribuer à des destinataires externes.

{
  "document": {
    "id": "a5e86d72-f5b7-43d4-a04e-8b7e08e6741c",
    "status": "success",
    "download_url": "https://pdfmonkey-production.s3.eu-west-1.amazonaws.com/...",
    "public_share_link": "https://files.pdfmonkey.io/share/72BE2293-D130-4C19-9E11-C82B5CEA8C37/invoice-2050-03.pdf"
  }
}

Quand le lien de partage apparaît

Le champ public_share_link est renseigné lorsque les deux conditions suivantes sont réunies :

1. Le statut du document est success.
2. Le compte est sur un plan Pro+ ou Premium.

Pour tout autre statut (draft, pending, generating, failure) ou sur un plan inférieur, le champ retourne null.

Format de l’URL

Les liens de partage suivent ce schéma :

https://files.pdfmonkey.io/share/{share_token}/{filename}

• share_token est un UUID attribué à chaque document lors de sa création. Il ne change pas.
• filename est le nom du fichier du document, extension comprise (.pdf, .png, .webp ou .jpg). Si vous définissez un nom de fichier personnalisé, il apparaît ici.

Affichage en ligne ou téléchargement

Par défaut, un lien de partage déclenche un téléchargement du fichier. Pour afficher le fichier directement dans le navigateur, ajoutez le paramètre disposition :

https://files.pdfmonkey.io/share/{share_token}/{filename}?disposition=inline

Liens de partage vs URL de téléchargement

Si vous avez besoin d’une URL valide indéfiniment, utilisez public_share_link. Si vous n’avez besoin que d’un lien de téléchargement éphémère (par exemple, pour enregistrer le fichier sur votre propre stockage juste après la génération), download_url suffit. Consultez L’URL de téléchargement pour plus de détails.

Changement de plan et liens de partage

Les liens de partage sont liés au plan de votre compte, pas aux documents individuels :

• Passage à un plan Pro+ ou Premium : tous les documents générés avec succès par le passé obtiennent rétroactivement un lien de partage fonctionnel. Aucune régénération n’est nécessaire.
• Passage à un plan inférieur au Pro+ : les liens de partage existants cessent de fonctionner immédiatement. Le champ public_share_link retourne null dans les réponses de l’API. De plus, les documents qui dépassent la durée de rétention du nouveau plan sont définitivement supprimés.
• Remise à niveau ultérieure : les liens de partage se réactivent automatiquement pour les documents encore existants. En revanche, les documents supprimés durant le passage à un plan inférieur en raison d’une rétention plus courte sont perdus définitivement et ne peuvent pas être récupérés.

Consultez Changer de plan pour plus de détails sur l’impact des changements de plan.

Fonctionne aussi avec les images

Les liens de partage fonctionnent pour tous les formats de sortie, pas seulement les PDF. Si votre template produit une image WebP, PNG ou JPG, le lien de partage pointe vers le fichier image avec l’extension correspondante.

Questions fréquentes

Pourquoi public_share_link est-il null alors que mon document est en success ?

Votre compte est probablement sur un plan qui n’inclut pas les liens de partage (Free, Starter ou Pro). Passez au plan Pro+ ou Premium pour activer cette fonctionnalité. Consultez Nos plans.

Peut-on révoquer un lien de partage pour un document spécifique ?

La suppression du document retire définitivement le lien de partage. Il n’existe pas de moyen de désactiver un lien de partage sans supprimer le document.

Les liens de partage survivent-ils à la suppression du document ?

Non. Une fois le document supprimé (manuellement ou via le TTL), le lien de partage retourne une erreur 404.

Le lien de partage est-il inclus dans les payloads des webhooks ?

Oui. Le champ public_share_link fait partie du payload du document envoyé à votre endpoint de webhook lors d’une génération réussie.

Pages liées

• L’URL de téléchargement — liens temporaires signés et comparaison avec les liens de partage
• Statuts et cycle de vie des documents — quand public_share_link devient disponible
• Nom de fichier personnalisé — contrôler le nom de fichier dans le lien de partage
• Suppression automatique (TTL) — impact de la suppression sur les liens de partage
• Nos plans — quels plans incluent les liens de partage
• Changer de plan — que deviennent les liens de partage lors d’un changement de plan
• Référence API Documents — documentation complète des champs, dont public_share_link

Questions fréquentes

Qu’est-ce qu’un lien de partage PDFMonkey ?

Un lien de partage est une URL publique permanente pour un document généré. Il n’expire jamais, ne nécessite aucune authentification et peut être intégré dans des emails, des pages web ou partagé directement. Disponible sur les plans Pro+ et Premium.

Quelle différence entre un lien de partage et une URL de téléchargement ?

Les URL de téléchargement sont temporaires (1 heure) et déclenchent toujours un téléchargement. Les liens de partage sont permanents. Par défaut, ils déclenchent un téléchargement, mais vous pouvez ajouter ?disposition=inline pour afficher le fichier dans le navigateur.

Les liens de partage fonctionnent-ils encore si je passe à un plan inférieur ?

Non. Les liens de partage cessent de fonctionner lors d’un passage à un plan inférieur au Pro+. Les documents qui dépassent la durée de rétention du nouveau plan sont définitivement supprimés. Si vous repassez sur un plan éligible, les liens de partage se réactivent pour les documents encore existants.