Files
SnapOtter/apps/docs/fr/tools/pdf/watermark-pdf.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.2 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Ajouter un filigrane textuel à chaque page d'un PDF. f1f7d8912fbd human b2024fb0f76a

Filigraner un PDF

Apposez un filigrane textuel sur chaque page d'un PDF avec une position, une taille, une opacité et une rotation configurables.

Point de terminaison de l'API

POST /api/v1/tools/pdf/watermark-pdf

Accepte des données de formulaire multipart avec un fichier PDF et un champ settings au format JSON.

Paramètres

Paramètre Type Requis Par défaut Description
text string Oui - Texte du filigrane (1-200 caractères)
position string Non "c" Emplacement sur la page : tl, tc, tr, l, c, r, bl, bc, br
fontSize integer Non 48 Taille de police en points (6-72)
opacity number Non 0.3 Opacité du filigrane (0.05-1)
rotation number Non 45 Angle de rotation en degrés (-180 à 180)

Valeurs de position

  • tl en haut à gauche, tc en haut au centre, tr en haut à droite
  • l au centre à gauche, c au centre, r au centre à droite
  • bl en bas à gauche, bc en bas au centre, br en bas à droite

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/pdf/watermark-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@document.pdf" \
  -F 'settings={"text": "CONFIDENTIAL", "position": "c", "opacity": 0.2, "rotation": 45}'

Exemple de réponse

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document.pdf",
  "originalSize": 2450000,
  "processedSize": 2500000
}

Remarques

  • Le filigrane est rendu sous forme de superposition de texte sur chaque page.
  • Le même texte, la même position et le même style de filigrane sont appliqués uniformément à toutes les pages.
  • Utilisez des valeurs d'opacité plus faibles (0.1-0.3) pour des filigranes subtils qui n'obscurcissent pas le contenu.