Définir un nom de fichier personnalisé pour les documents générés

Dernière mise à jour le 23 mars 2026

Par défaut, PDFMonkey nomme les fichiers générés avec un identifiant interne. Vous pouvez remplacer ce comportement en passant une clé _filename dans les métadonnées du document — cela fonctionne aussi bien pour les PDF que pour les images.

Définir le nom de fichier via l’API

Incluez la clé _filename dans l’objet meta lorsque vous créez ou mettez à jour un document :

curl https://api.pdfmonkey.io/api/v1/documents \
  -X POST \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "document": {
      "document_template_id": "YOUR_TEMPLATE_ID",
      "status": "pending",
      "payload": { "name": "Jane Doe" },
      "meta": {
        "_filename": "facture-2050-03.pdf"
      }
    }
  }'

Le champ meta accepte un objet JSON. Vous pouvez inclure d’autres clés de métadonnées en plus de _filename — consultez la référence API Documents pour tous les détails.

Définir le nom de fichier depuis le tableau de bord

  1. Ouvrez un document dans l’éditeur de document.
  2. Passez à l’onglet Meta data.
  3. Saisissez la clé _filename et le nom souhaité :
{
  "_filename": "facture-2050-03.pdf"
}
  1. Cliquez sur Save, puis sur Generate.

Pour un guide complet, consultez Générer des documents depuis le tableau de bord.

Gestion de l’extension de fichier

PDFMonkey gère automatiquement l’extension en fonction du format de sortie (PDF, PNG, WebP ou JPG) :

  • Si vous incluez l’extension correspondante (par ex. facture.pdf pour un modèle PDF), PDFMonkey la retire et la ré-ajoute pour garder le nom propre.
  • Si vous omettez l’extension, PDFMonkey ajoute automatiquement la bonne.
  • Si vous incluez une extension incorrecte (par ex. .png sur un document PDF), elle est traitée comme faisant partie du nom et l’extension correcte est quand même ajoutée.
Inutile de vous soucier de l’extension. Fournissez simplement le nom souhaité et laissez PDFMonkey faire le reste.

Assainissement du nom de fichier

PDFMonkey assainit la valeur de _filename pour garantir sa compatibilité avec tous les systèmes de fichiers :

RègleExemple
Les caractères accentués sont translittérés en ASCIIcafe-resume devient cafe-resume
Les caractères autres que lettres, chiffres, tirets, underscores et espaces sont remplacés par un tiretreport@2050/03 devient report-2050-03
Les tirets consécutifs sont fusionnésreport---final devient report-final
Les tirets en début et fin de chaîne sont supprimés-my-file- devient my-file
Les espaces en début et fin de chaîne sont supprimés" invoice " devient "invoice"

Par exemple, une valeur "Facture n 2050/03" pour un modèle PDF produit le nom de fichier Facture n-2050-03.pdf.

Fonctionne aussi avec les images

La clé _filename fonctionne de la même manière pour les formats d’image. L’extension est ajustée en fonction du type d’image (.webp, .png ou .jpg) :

{
  "meta": {
    "_filename": "social-card-march",
    "_type": "png"
  }
}

Cela produit un fichier nommé social-card-march.png.

Questions fréquentes

Que se passe-t-il si je ne définis pas de nom de fichier personnalisé ?

PDFMonkey utilise un nom par défaut interne. Si vous avez besoin de noms de fichiers prévisibles pour l’archivage ou des systèmes en aval, définissez toujours _filename.

Puis-je utiliser des données dynamiques dans le nom de fichier ?

Pas directement dans la valeur _filename. Cependant, dans la plupart des plateformes d’intégration (Zapier, Make, n8n), vous pouvez utiliser des champs dynamiques ou des expressions pour construire la chaîne du nom de fichier avant de la transmettre à PDFMonkey.

Y a-t-il une longueur maximale pour le nom de fichier ?

Il n’y a pas de limite explicite imposée par PDFMonkey, mais gardez des noms de fichiers raisonnables (moins de 200 caractères) pour éviter les problèmes avec les systèmes de fichiers et les navigateurs.

Pages associées

Questions fréquentes

Comment définir un nom de fichier personnalisé pour un document PDFMonkey ?
Passez une clé "_filename" dans le champ meta du document. Via l’API, incluez-la dans l’objet meta lors de la création ou de la mise à jour d’un document : "meta": { "_filename": "facture-2050.pdf" }. Dans le tableau de bord, saisissez-la dans l’onglet Métadonnées de l’éditeur de document.
PDFMonkey ajoute-t-il l’extension de fichier automatiquement ?
Oui. Si vous incluez la bonne extension (.pdf, .png, .webp, .jpg), PDFMonkey la retire et la ré-ajoute pour garder le nom propre. Si vous l’omettez, PDFMonkey l’ajoute automatiquement en fonction du format de sortie.
Quels caractères sont autorisés dans le nom de fichier personnalisé ?
PDFMonkey assainit le nom de fichier : les caractères accentués sont translittérés en ASCII, tout caractère qui n’est pas une lettre, un chiffre, un tiret, un underscore ou un espace est remplacé par un tiret, et les tirets consécutifs ou en début/fin de chaîne sont supprimés.
Navigation