Ajouter un tampon d'image à PDF - Filigrane API

PDF4me Ajouter un tampon d'image à PDF vous permet d'ajouter des tampons et des filigranes d'image personnalisables à PDF documents. Ceci API processus de service PDF Il permet d'ajouter des filigranes d'image aux fichiers, avec des options de positionnement précis, de dimensionnement personnalisé et de mise en forme, pour la personnalisation et la sécurité des documents. API reçoit PDF contenu et données d'image via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Grâce à la prise en charge du positionnement flexible, du dimensionnement personnalisé, du ciblage de pages et du contrôle d'impression, cette solution est idéale pour la personnalisation des documents, la protection des droits d'auteur 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

• Prise en charge des filigranes d'image: Ajoutez des images personnalisées comme filigranes et tampons à PDF documents
• Positionnement flexibleContrôlez l'alignement horizontal et vertical avec une précision au pixel près.
• Tailles personnalisées: Ajuster les dimensions de l'image à l'aide des mesures en millimètres et en pixels
• Mise en forme avancéeDéfinissez l'opacité, les marges et les options d'arrière-plan pour un rendu professionnel.
• 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 d'image qui renforcent la sécurité des documents et l'image de marque.
• Sans couture API Intégration: REST API conçu pour l'automatisation PDF flux de travail d'édition et intégration des systèmes d'entreprise

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 d'image sont effectuées via un point de terminaison unique :

• Méthode: POST
• Point final : /api/v2/ImageStamp

Fonctionnalités d'estampage d'images

Prise en charge des formats d'image

• Formats courants: Soutien à JPG, PNG, GIF et autres formats d'image standard
• Base64 Encodage: Transmission sécurisée d'images via Base64 encodage
• Contrôle de la taille: Options de dimensionnement en millimètres (10-200 mm) et en pixels (20-600 px)

Positionnement et mise en page

• Alignement horizontalOptions de positionnement à gauche, au centre ou à droite
• Alignement verticalContrôle du placement en haut, au milieu ou en bas
• Contrôle des margesPositionnement précis grâce à des mesures en millimètres (0-100 mm) et en pixels (0-300 px).
• Ciblage de pageAppliquer à des pages spécifiques en utilisant les options de page (chaîne vide pour toutes les pages, "1", "1,3,5", "2-5", "1,3,7-10", "2-")

Fonctionnalités avancées

• Contrôle de l'opacitéTransparence réglable (0-100) : 0 = invisible, 100 = totalement opaque
• Mode arrière-plan: Option permettant de placer des images derrière (isBackground: true) ou devant (isBackground: false) de contenu
• Contrôle d'impression: Configurer les timbres pour qu'ils n'apparaissent qu'à l'impression (showOnlyInPrint: true) ou en vue et en impression (showOnlyInPrint: false)
• Traitement asynchrone: Prise en charge du traitement asynchrone avec interrogation pour les opérations de longue durée

REST API Paramètres

Liste complète des paramètres pour l'ajout d'un tampon d'image à 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ètre	Taper	Description	Exemple
Nom du document*	String	Sortir PDF Nom de fichier avec l'extension .pdf	output.pdf
docContent*	Base64	Le contenu de l'entrée PDF fichier encodé en Base64	JVBERi...
nom_de_l'image*	String	Nom du fichier image avec son extension (par exemple, .png, .jpg)	stamp.png
fichier image*	Base64	Contenu du fichier image encodé en Base64 format	iVBORw0KGgoAAAANS...
alignerX*	String	Alignement horizontal : Gauche, Centre, ou Droite	Center
aligner*	String	Alignement vertical : Haut, Milieu, ou Bas	Middle

Paramètres optionnels

Paramètre	Taper	Description	Exemple
pages	String	Options de page : chaîne vide pour toutes les pages, "1" pour la page 1, "1,3,5" pour des pages spécifiques, "2-5" pour la plage de pages, "1,3,7-10" pour mixte, "2-" pour les pages de 2 à la fin	"" ou "1-3"
hauteur en mm	String	Hauteur de l'image en millimètres (10-200)	30
largeur en mm	String	Largeur de l'image en millimètres (10-200)	30
hauteur en pixels	String	Hauteur de l'image en pixels (20-600)	85
largeur en pixels	String	Largeur de l'image en pixels (20-600)	85
margeXInMM	String	Marge horizontale en millimètres (0-100)	10
margeYInMM	String	Marge verticale en millimètres (0-100)	10
margeXInPx	String	Marge horizontale en pixels (0-300)	28
margeYInPx	String	Marge verticale en pixels (0-300)	28
opacité	Integer	Niveau d'opacité (0-100) : 0 = invisible, 100 = totalement opaque	50
estBackground	Boolean	Placer le timbre en arrière-plan (vrai) ou au premier plan (faux)	true
afficherUniquementImprimé	Boolean	Afficher uniquement en impression (vrai) ou en visualisation et impression (faux)	false
asynchrone	Boolean	Activer le traitement asynchrone. Lorsque true, le API renvoie un statut 202 et fournit un système d'interrogation URL dans le Location en-tête	true

Sortir

Le PDF4me Ajouter un tampon d'image à 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.

Success Response

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 d'image appliqué, 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

Asynchronous Processing

Traitement asynchrone

Quand async: true est réglé, le API traite la requête de manière asynchrone :

Code d'état : 202 Accepted

En-têtes de réponse :

Location: https://api.pdf4me.com/api/v2/ImageStamp/poll/12345-abcde-67890

Processus de sondage :

1. Extraire le Location En-tête de la réponse 202
2. Sondage URL en utilisant GET demandes
3. Continuez à sonder jusqu'à ce que vous receviez un 200 OK statut
4. La réponse finale contient la même chose JSON format avec docName et docContent (Base64)

Exemple de sondage :

// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');

// Poll until complete
while (true) {
  const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
  if (pollResponse.status === 200) {
    const data = await pollResponse.json();
    // Process data.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Error Responses

Réponses d'erreur

Le API retours standard HTTP codes d'erreur avec détails de l'erreur :

400 Bad Request

• Paramètres de requête invalides
• Champs obligatoires manquants (Nom du document, docContent, nom_de_l'image, fichier image, alignerX, aligner)
• Invalide Base64 encodage dans docContent ou fichier image
• Valeurs d'alignement invalides (doivent être : Gauche/Centre/Droite pour alignX, Haut/Milieu/Bas pour alignY)
• Valeurs de taille ou de marge non valides (hors des plages autorisées)

401 Unauthorized

• Invalide ou manquant API clé
• API clé non correctement Base64 encodé dans Authorization en-tête
• Manquant Autorisation : de base en-tête

500 Internal Server Error

• Erreur de traitement côté serveur
• PDF échec du traitement
• Échec de l'application du tampon d'image

Format de réponse en cas d'erreur :

{
  "error": "Error message describing what went wrong"
}

Response Format Details

Détails du format de réponse

Important: Le API toujours retourne JSON, jamais binaire PDF données directement.

Structure de la réponse :

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type En-tête :

• Succès: application/json
• Le PDF est intégré en tant que Base64 chaîne à l'intérieur de la JSON réponse

Pourquoi Base64?

• JSON-codage sûr pour les données binaires
• Facile à transmettre sur HTTP
• Compatible avec tous les langages de programmation
• Peut être directement intégré dans JSON sans échapper aux problèmes

Décodage Base64 à PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", 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==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle"
}

Exemple avancé (avec tous les champs facultatifs) :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle",
  "pages": "",
  "heightInMM": "30",
  "widthInMM": "30",
  "heightInPx": "85",
  "widthInPx": "85",
  "marginXInMM": "10",
  "marginYInMM": "10",
  "marginXInPx": "28",
  "marginYInPx": "28",
  "opacity": 50,
  "isBackground": true,
  "showOnlyInPrint": false,
  "async": true
}

Exemples de code

Le PDF4me Ajouter un tampon d'image à 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#

C# (CSharp) Échantillon

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

View C# Sample

Java

Java Échantillon

Java implémentation avec gestion complète des erreurs et traitement des réponses :

View Java Sample

JavaScript

JavaScript Échantillon

Node.js et compatible avec les navigateurs JavaScript mise en œuvre:

View JavaScript Sample

Python

Python Échantillon

Python implémentation avec la bibliothèque requests et JSON manutention:

View Python Sample

Salesforce

Salesforce Échantillon

Salesforce Apex mise en œuvre pour CRM intégration :

View Salesforce Sample

n8n

n8n Échantillon

n8n Mise en œuvre des flux de travail pour l'automatisation :

View n8n Sample

Google Script

Google Script Échantillon

Google Apps Script mise en œuvre pour Google Workspace intégration :

View Google Script Sample

AWS Lambda

AWS Lambda Échantillon

sans serveur AWS Lambda implémentation de la fonction :

View AWS Lambda Sample

Cas d'utilisation et applications industrielles

Legal & Professional Services

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 tampons d'image aux contrats et accords
• Avis de confidentialitéAppliquer des cachets de confidentialité aux documents juridiques sensibles.
• Timbres de conformitéAjouter des mentions légales de conformité réglementaire aux documents juridiques

Business & Enterprise

Cas d'utilisation en entreprise

• Image de marque des documentsAjoutez des logos d'entreprise, des filigranes et des éléments de marque aux documents PDF.
• Indicateurs d'étatAjoutez les mentions « BROUILLON », « CONFIDENTIEL » ou « APPROUVÉ » pour indiquer l’état du document.
• Génération de rapportsAjouter des horodatages, des numéros de page et des identifiants de rapport aux documents générés
• Image de marque d'entrepriseAppliquer une image de marque cohérente à tous les documents commerciaux

Finance & Banking

Cas d'utilisation dans le secteur financier et bancaire

• Rapports financiersAjouter des tampons d'image aux rapports et états financiers
• Estampillage des facturesApposez des tampons d'approbation sur les factures et les bons de commande.
• Documentation de conformitéAjouter des timbres réglementaires aux documents financiers
• Pistes d'auditCréer des pistes d'audit avec horodatage d'images sur les documents financiers

Government & Compliance

Cas d'utilisation gouvernementaux et de conformité

• Protection du droit d'auteurAppliquer des mentions de droit d'auteur et des marques de propriété intellectuelle pour protéger la propriété intellectuelle
• Conformité réglementaireAjouter des tampons d'image de conformité pour répondre aux exigences réglementaires
• Documentation officielle: Apposer des cachets officiels sur les documents gouvernementaux
• Archives publiquesAjouter des timbres d'imagerie de classification aux registres et documents publics

Obtenez de l'aide

Get Your API KeyAPI SamplesGetting Started