Rétention des documents et suppression automatique (TTL)

Chaque document généré est stocké sur les serveurs de PDFMonkey jusqu’à son expiration ou sa suppression. Vous contrôlez la durée de vie des documents en définissant un TTL (Time To Live) sur chaque modèle. Lorsque le TTL d’un document expire, PDFMonkey le supprime automatiquement ainsi que son fichier généré.

Fonctionnement du TTL

Le TTL est un paramètre par modèle exprimé en secondes. Lorsqu’un document termine sa génération avec succès, PDFMonkey calcule son heure d’expiration en ajoutant le TTL au timestamp de génération. Une tâche de fond s’exécute chaque minute pour supprimer tous les documents dont l’expiration est passée.

Le décompte commence lorsque le document atteint le statut success, et non lorsqu’il est créé ou mis en file d’attente.

Configurer le TTL dans le tableau de bord

Ouvrez l’onglet Settings de votre modèle et repérez le menu déroulant Deletion. Sélectionnez la durée de rétention qui correspond à vos besoins :

Les options disponibles dépendent de votre forfait. Si vous sélectionnez une valeur non prise en charge par votre forfait, PDFMonkey la plafonne au maximum autorisé.

Valeurs TTL disponibles par forfait

Définir le TTL via l’API

Lors de la création ou de la mise à jour d’un modèle via l’API Templates, incluez le champ ttl avec une valeur en secondes :

{
  "document_template": {
    "identifier": "invoice-template",
    "ttl": 3600
  }
}

Le même plafonnement par forfait s’applique : si vous demandez un TTL qui dépasse le maximum de votre forfait, l’API utilise silencieusement la valeur la plus élevée autorisée au lieu de renvoyer une erreur.

Ce qui est supprimé

Lorsqu’un document est supprimé (que ce soit par expiration du TTL, suppression manuelle dans le tableau de bord ou via un appel API), PDFMonkey supprime :

• Le fichier généré (PDF, PNG, WebP ou JPG) du stockage
• Le payload (les données dynamiques envoyées pour générer le document)
• Les données meta associées au document

Le document n’apparaît plus dans les réponses de l’API ni dans le tableau de bord. Tout lien de partage pointant vers le document renvoie une erreur 404.

Changements de forfait et rétention

Lorsque vous changez de forfait, PDFMonkey ajuste les paramètres TTL pour correspondre aux limites du nouveau forfait :

• Passage à un forfait supérieur : les modèles conservent leur TTL actuel. Si vous aviez défini un TTL inférieur en raison de restrictions de forfait, vous pouvez désormais l’augmenter jusqu’au maximum de votre nouveau forfait.
• Passage à un forfait inférieur : tout modèle dont le TTL dépasse le maximum du nouveau forfait est automatiquement plafonné. Les documents existants de ces modèles voient leurs dates d’expiration recalculées, ce qui peut entraîner une expiration plus rapide que prévu initialement.

Consultez Changer de forfait pour un aperçu plus large de l’impact des changements de forfait sur votre compte.

Suppression manuelle

Si vous préférez supprimer des documents selon votre propre calendrier plutôt que de compter sur le TTL, vous avez deux options :

1. Tableau de bord : ouvrez le document et cliquez sur le bouton de suppression.
2. API : envoyez une requête DELETE à /api/v1/documents/:id. Consultez la référence API pour plus de détails.

La suppression manuelle retire les mêmes données que la suppression automatique par TTL.

Questions fréquentes

Pourquoi mon document a-t-il été supprimé avant le TTL que j’avais défini ?

Si vous avez récemment rétrogradé votre forfait, PDFMonkey a peut-être recalculé les dates d’expiration des documents existants. Un modèle configuré sur « 1 semaine » avec un forfait Pro rétrogradé en Starter (maximum 1 jour) voit le TTL de ses documents raccourci en conséquence.

Puis-je définir des valeurs TTL différentes pour différents modèles ?

Oui. Le TTL est un paramètre par modèle. Chaque modèle de votre compte peut avoir sa propre durée de rétention, dans les limites de votre forfait.

Le TTL s’applique-t-il aux documents en échec ?

Non. Seuls les documents avec un statut success reçoivent une date d’expiration. Les documents en échec ne sont pas supprimés automatiquement par le système TTL.

Existe-t-il une API pour vérifier quand un document expire ?

L’objet document n’expose pas directement le champ expires_at. Cependant, vous pouvez le calculer à partir de la valeur ttl du modèle et du timestamp updated_at du document.

Pages liées

• Statuts et cycle de vie des documents — comprendre quand les documents deviennent éligibles à la suppression automatique
• L’URL de téléchargement — sauvegarder vos fichiers avant leur expiration
• Liens de partage permanents — impact de la suppression sur les liens de partage
• Nos forfaits — limites de rétention par forfait en un coup d’œil
• Changer de forfait — impact des changements de forfait sur les paramètres TTL
• Stockage des données et rétention — aperçu général de ce que PDFMonkey stocke
• API : Templates — définir le TTL lors de la création ou mise à jour d’un modèle
• API : Documents — supprimer des documents par programmation

Questions fréquentes

Combien de temps PDFMonkey conserve-t-il mes documents générés ?

Cela dépend de votre forfait et du réglage TTL. Les forfaits Free et Starter conservent les documents jusqu’à 1 jour. Le forfait Pro permet jusqu’à 7 jours. Les forfaits Pro+ et Premium offrent une rétention illimitée. Dans ces limites, vous définissez le TTL exact par modèle.

Quelles données sont supprimées à l’expiration d’un document ?

Lorsqu’un document est supprimé (manuellement ou via TTL), PDFMonkey supprime le fichier généré du stockage et efface les données payload et meta. Le document n’apparaît plus dans l’API ni dans le tableau de bord.

Puis-je supprimer des documents manuellement au lieu d’utiliser le TTL ?

Oui. Vous pouvez supprimer des documents depuis le tableau de bord PDFMonkey ou en appelant l’endpoint DELETE /api/v1/documents/:id. La suppression manuelle retire les mêmes données que la suppression automatique par TTL.

Que se passe-t-il pour mes paramètres TTL si je rétrograde mon forfait ?

Lors d’une rétrogradation, tout modèle dont le TTL dépasse le maximum du nouveau forfait est automatiquement plafonné à ce maximum. Les dates d’expiration des documents existants de ces modèles sont recalculées en conséquence.