Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Ajouter un tampon de texte à PDF - Filigrane de texte API

PDF4me Ajouter un tampon de texte à PDF vous permet d'ajouter des filigranes de texte personnalisables à PDF Documents d'autorisation et de prévention du piratage. API processus de service PDF et ajoute des tampons de texte avec un contrôle précis sur le texte, la position, le style, la rotation et l'apparence. API reçoit PDF contenu via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Cette solution est idéale pour la personnalisation des documents, la protection des droits d'auteur, les indicateurs de statut et les applications d'entreprise. PDF flux de travail.

Articles de blog connexes
Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.
En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.
Consultez le blog →

Authentification de votre API Demande​

Pour accéder au PDF4me REST APIChaque requête doit inclure des informations d'authentification valides. L'authentification garantit la sécurité des communications et confirme votre identité en tant qu'utilisateur autorisé. REST API.

Get your api Key

Caractéristiques principales​

  • Positionnement flexibleContrôlez l'alignement horizontal et vertical avec une précision au pixel près.
  • Style personnaliséChoisissez parmi différentes polices, tailles, couleurs et effets de texte (gras, italique, souligné).
  • Mise en forme avancée: Définir les options d'opacité, de rotation, de marges et d'arrière-plan
  • Ciblage de page: Appliquer les tampons à des pages spécifiques ou à des documents entiers
  • Contrôle d'impressionConfigurer les timbres pour qu'ils apparaissent uniquement à l'impression ou à l'écran
  • Résultats professionnelsCréez des filigranes qui renforcent la sécurité des documents et l'image de marque.
  • Traitement asynchrone: Prise en charge du traitement asynchrone avec interrogation pour les opérations de longue durée

REST API Point de terminaison​

Le PDF4me REST API utilise la norme HTTP méthodes d'interaction avec les ressources. Toutes les opérations d'ajout de tampon de texte sont effectuées via un point de terminaison unique :

  • Méthode: POSTE
  • Point final : /api/v2/Stamp

Fonctionnalités d'estampillage de texte prises en charge​

Le API offre une prise en charge complète de diverses fonctionnalités d'estampage et de filigrane de texte :

Options de personnalisation du texte​

  • Sélection de policeChoisissez parmi Arial, Times New Roman, Helvetica ou Courier New Roman.
  • Contrôle de la tailleTaille de police ajustable de 8 à 72
  • Options de couleur: Prise en charge complète du spectre des couleurs avec codes de couleur hexadécimaux (par exemple, #FF0000 pour le rouge)
  • Effets de texteOptions de mise en forme : gras, italique et souligné
  • Texte personnalisé: Prise en charge de tout contenu textuel, y compris les symboles et les caractères spéciaux

Positionnement et mise en page​

  • Alignement horizontalOptions de positionnement à gauche, au centre et à droite
  • Alignement verticalContrôle du placement en haut, au milieu et en bas
  • Contrôle des margesPositionnement précis grâce à des mesures millimétriques et pixel-à-pixel.
  • Support de rotationRotation du texte : 0 (horizontal), 45 (diagonal), 90 (vertical), -45 (diagonal inversé)
  • Placement flexible: Prise en charge de n'importe quelle position de page avec des mesures exactes

Fonctionnalités avancées​

  • Contrôle de l'opacitéTransparence réglable (0-100) pour des filigranes discrets ou proéminents
  • Mode arrière-plan: Possibilité de placer le texte derrière ou devant le contenu
  • Contrôle d'impressionConfigurez les timbres pour qu'ils apparaissent en mode affichage et impression ou impression uniquement.
  • Ciblage de pageAppliquer à des pages spécifiques ou à des documents entiers
  • Adaptation du texte: Adaptation automatique de la taille du texte aux limites de la page (optionnel)

REST API Paramètres​

Liste complète des paramètres pour l'ajout d'un tampon de texte à PDF REST APILes paramètres sont organisés par catégorie pour une meilleure compréhension et une mise en œuvre plus aisée.

Important: Les paramètres marqués d'un astérisque (*) sont obligatoires et doivent être fournis pour le API pour fonctionner correctement.

Paramètres requis​

ParamètreTaperDescriptionExemple
Nom du document*ChaîneSortir PDF Nom de fichier avec l'extension .pdfoutput.pdf
docContent*Base64PDF contenu du fichier encodé en Base64JVBERi...
pages*ChaîneOptions de page : « tout », « 1 », « 1,3,5 », « 2-5 », « 1,3,7-10 », « 2- »all
texte*ChaîneTexte à apposer en filigraneCONFIDENTIAL - PDF4me Watermark
alignerX*ChaîneAlignement horizontal : gauche, centre, ou droitecenter
aligner*ChaîneAlignement vertical : haut, milieu, ou basmiddle

Paramètres optionnels​

ParamètreTaperDescriptionExemple
margeXInMMChaîneMarge horizontale à partir du bord gauche en millimètres50
margeYInMMChaîneMarge verticale à partir du bord supérieur en millimètres50
margeXInPxChaîneMarge horizontale à partir du bord gauche en pixels150
margeYInPxChaîneMarge verticale à partir du bord supérieur en pixels150
opacitéChaîneOpacité (0-100) : 0 = invisible, 100 = totalement opaque30
nom de policeChaîneNom de la police : Arial, Times New Roman, Helvetica, Courrier NewArial
taille de policeEntierTaille de police (8-72)24
couleur de policeChaîneCouleur de police au format hexadécimal (par exemple, #FF0000 pour le rouge)#FF0000
boule de glacebooléenMettre le texte en gras (vrai) ou normal (faux)true
isItalicsbooléenMettre le texte en italique (vrai) ou en normal (faux)false
soulignerbooléenSoulignez le texte (vrai) ou (faux)false
tournerEntierAngle de rotation : 0 (horizontal), 45 (diagonale), 90 (verticale), -45 (diagonale inversée)45
estBackgroundbooléenPlacer le timbre en arrière-plan (vrai) ou au premier plan (faux)true
afficherUniquementImprimébooléenAfficher le timbre en vue et imprimer (faux) ou imprimer seulement (vrai)false
transversalbooléenPositionnement transversal (vrai) ou normal (faux)false
ajusterTexteSurPagebooléenAjuster le texte à toute la page (vrai) ou utiliser la taille spécifiée (faux)false
asynchronebooléenActiver le traitement asynchrone. Lorsque true, le API renvoie un statut 202 et fournit un système d'interrogation URL dans le Location en-têtetrue

Sortir​

Le PDF4me Ajouter un tampon de texte à PDF REST API renvoie des réponses différentes selon le mode de traitement. API renvoie le PDF comme un Base64chaîne encodée dans JSON format, et non sous forme de données binaires.

Traitement synchrone (par défaut)

Quand async n'est pas défini ou est défini sur false, le API traite la demande immédiatement :

Code d'état : 200 OK

Content-Type: application/json

Corps de la réponse :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Champs de réponse :

  • Nom du document (chaîne de caractères) : La sortie PDF nom de fichier
  • docContent (chaîne de caractères) : Le PDF fichier avec tampon de texte ajouté, encodé comme Base64 chaîne

Mode d'emploi :

  1. Extraire le docContent champ du JSON réponse
  2. Décodez le Base64 chaîne permettant d'obtenir le binaire PDF données
  3. Enregistrer ou traiter le PDF classer selon les besoins

Exemple (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

Exemple de requête​

En-tête​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Note:

  • Obtenez votre API clé de la PDF4me Tableau de bord
  • Le API La clé doit être Base64 encodé et préfixé par « Basic » dans le Authorization en-tête
  • Exemple : Si votre API La clé est abc123, encodez-le en Base64 et utiliser Authorization: Basic YWJjMTIz

Charge utile​

Exemple simple (champs obligatoires uniquement) :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle"
}

Exemple avancé (avec tous les champs facultatifs) :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle",
  "marginXInMM": "50",
  "marginYInMM": "50",
  "marginXInPx": "150",
  "marginYInPx": "150",
  "opacity": "30",
  "fontName": "Arial",
  "fontSize": 24,
  "fontColor": "#FF0000",
  "isBold": true,
  "isItalics": false,
  "underline": false,
  "rotate": 45,
  "isBackground": true,
  "showOnlyInPrint": false,
  "transverse": false,
  "fitTextOverPage": false,
  "async": true
}

Exemples de code​

Le PDF4me Ajouter un tampon de texte à PDF REST API propose des exemples de code dans plusieurs langages de programmation. Choisissez le langage qui convient le mieux à votre environnement de développement :

C# Exemple (CSharp)

Complet C# implémentation pour l'ajout de tampons de texte à PDF:

Fonctionnalités d'estampillage de texte​

Options de personnalisation​

  • Contrôle des policesPlusieurs familles de polices avec personnalisation de la taille et de la couleur
  • Effets de texteOptions de mise en forme : gras, italique et souligné
  • Gestion des couleurs: Prise en charge complète des couleurs avec codes hexadécimaux
  • Contenu textuel: Prise en charge de tout texte, y compris les symboles et les caractères spéciaux
  • Coiffure professionnelle: Rendu de texte de haute qualité avec une visibilité claire

Positionnement et mise en page​

  • Contrôle d'alignementOptions d'alignement horizontal et vertical précises
  • Paramètres de marge: Positionnement au millimètre et au pixel près
  • Support de rotationRotation du texte pour les filigranes diagonaux ou inclinés
  • Placement flexible: Prise en charge de toute position et orientation de page
  • Ciblage de pageAppliquer à des pages spécifiques ou à des documents entiers

Fonctionnalités avancées​

  • Contrôle de l'opacitéTransparence ajustable pour des filigranes discrets ou proéminents
  • Mode arrière-plan: Possibilité de placer le texte derrière ou devant le contenu
  • Contrôle d'impressionConfigurer les timbres pour qu'ils apparaissent uniquement à l'impression ou à l'écran
  • Adaptation du texte: Adaptation automatique de la taille du texte aux limites de la page
  • Mode transversalAppliquez les tampons sur toute la page.

Cas d'utilisation et applications industrielles​

Cas d'utilisation des services juridiques et professionnels

  • Documentation juridique: Intégrer des mentions légales et des avis de confidentialité dans les documents juridiques
  • Estampillage de contratAjouter des mentions d'état aux contrats et accords
  • Avis de confidentialitéApposer des cachets de confidentialité sur les documents juridiques sensibles
  • Timbres de conformité: Ajouter des mentions de conformité réglementaire aux documents juridiques

Obtenez de l'aide​

Get Your API KeyAPI SamplesGetting Started