Aggiungi timbro immagine a PDF - Filigrana API

PDF4me Aggiungi timbro immagine a PDF consente di aggiungere timbri e filigrane personalizzabili a PDF documenti. Questo API processi di servizio PDF file e aggiunge filigrane di immagini con posizionamento preciso, dimensioni personalizzate e opzioni di formattazione per il branding e la sicurezza dei documenti. API riceve PDF dati di contenuto e immagine tramite REST API chiamate, utilizzando Base64 codifica per una trasmissione sicura. Con supporto per posizionamento flessibile, dimensionamento personalizzato, targeting della pagina e controllo della stampa, questa soluzione è ideale per la personalizzazione dei documenti, la protezione del copyright e le applicazioni aziendali. PDF flussi di lavoro.

Articoli correlati del blog

Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.

Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.

Visita il blog →

Autenticazione del tuo API Richiesta

Per accedere al PDF4me REST API, ogni richiesta deve includere credenziali di autenticazione adeguate. L'autenticazione garantisce una comunicazione sicura e convalida la tua identità come utente autorizzato del REST API.

Get your api Key

Caratteristiche principali

• Supporto per filigrana immagine: Aggiungi immagini personalizzate come filigrane e timbri a PDF Documenti
• Posizionamento flessibile: Controllo dell'allineamento orizzontale e verticale con precisione al pixel
• Dimensioni personalizzateRegola le dimensioni dell'immagine utilizzando sia le misure in millimetri che in pixel.
• Formattazione avanzataImposta opacità, margini e opzioni di sfondo per un aspetto professionale.
• Targeting della pagina: Applicare timbri a pagine specifiche o a interi documenti
• Controllo di stampaConfigura i timbri in modo che vengano visualizzati solo in stampa o a schermo
• Risultati professionali: Crea filigrane per immagini che migliorano la sicurezza dei documenti e l'immagine del marchio
• senza veli API Integrazione: REST API progettato per l'automazione PDF flussi di lavoro di modifica e integrazione con i sistemi aziendali

REST API Punto finale

IL PDF4me REST API utilizza standard HTTP Metodi per interagire con le risorse. Tutte le operazioni di aggiunta di timbri immagine vengono eseguite tramite un singolo endpoint:

• Metodo: POST
• Punto finale: /api/v2/ImageStamp

Caratteristiche di stampa dell'immagine

Supporto per i formati immagine

• Formati comuni: Supporto per JPG, PNG, GIF e altri formati di immagine standard
• Base64 Codifica: Trasmissione sicura delle immagini tramite Base64 codifica
• Controllo delle dimensioni: Opzioni di dimensionamento sia in millimetri (10-200 mm) che in pixel (20-600 px).

Posizionamento e disposizione

• Allineamento orizzontaleOpzioni di posizionamento: Sinistra, Centro o Destra
• Allineamento verticaleControllo del posizionamento: Superiore, Centrale o Inferiore
• Controllo dei marginiPosizionamento preciso con misurazioni sia in millimetri (0-100 mm) che in pixel (0-300 px)
• Targeting della pagina: Applicare a pagine specifiche utilizzando le opzioni di pagina (stringa vuota per tutte le pagine, "1", "1,3,5", "2-5", "1,3,7-10", "2-")

Funzionalità avanzate

• Controllo dell'opacitàTrasparenza regolabile (0-100): 0=invisibile, 100=completamente opaco
• Modalità in background: Opzione per posizionare le immagini dietro (isBackground: true) o davanti (isBackground: false) di contenuto
• Controllo di stampa: Configura i timbri in modo che vengano visualizzati solo in stampa (showOnlyInPrint: true) o in visualizzazione e stampa (showOnlyInPrint: false)
• Elaborazione asincronaSupporto per l'elaborazione asincrona con polling per operazioni di lunga durata

REST API Parametri

Elenco completo dei parametri per Aggiungi timbro immagine a PDF REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.

Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori e devono essere forniti per il API per funzionare correttamente.

Parametri richiesti

Parametro	Tipo	Descrizione	Esempio
docName*	String	Produzione PDF nome del file con estensione .pdf	output.pdf
docContent*	Base64	Il contenuto dell'input PDF file codificato in Base64	JVBERi...
nomeimmagine*	String	Nome del file immagine con estensione (ad esempio, .png, .jpg)	stamp.png
file immagine*	Base64	Contenuto del file immagine codificato in Base64 formato	iVBORw0KGgoAAAANS...
allineaX*	String	Allineamento orizzontale: Sinistra, Centro, O Giusto	Center
allineamentoY*	String	Allineamento verticale: Superiore, Mezzo, O Metter il fondo a	Middle

Parametri opzionali

Parametro	Tipo	Descrizione	Esempio
pagine	String	Opzioni pagina: stringa vuota per tutte le pagine, "1" per la pagina 1, "1,3,5" per pagine specifiche, "2-5" per l'intervallo di pagine, "1,3,7-10" per misto, "2-" per le pagine da 2 alla fine	"" O "1-3"
altezza in mm	String	Altezza dell'immagine in millimetri (10-200)	30
larghezzaInMM	String	Larghezza dell'immagine in millimetri (10-200)	30
altezzaInPx	String	Altezza dell'immagine in pixel (20-600)	85
larghezzaInPx	String	Larghezza dell'immagine in pixel (20-600)	85
marginXInMM	String	Margine orizzontale in millimetri (0-100)	10
marginYInMM	String	Margine verticale in millimetri (0-100)	10
marginXInPx	String	Margine orizzontale in pixel (0-300)	28
marginYInPx	String	Margine verticale in pixel (0-300)	28
opacità	Integer	Livello di opacità (0-100): 0=invisibile, 100=completamente opaco	50
è lo sfondo	Boolean	Posiziona il timbro sullo sfondo (vero) o in primo piano (falso)	true
mostra solo in formato cartaceo	Boolean	Mostra solo in stampa (vero) o visualizza e stampa (falso)	false
asincrono	Boolean	Abilita l'elaborazione asincrona. Quando true, IL API restituisce uno stato 202 e fornisce un polling URL nel Location intestazione	true

Produzione

IL PDF4me Aggiungi timbro immagine a PDF REST API restituisce risposte diverse a seconda della modalità di elaborazione. API restituisce il PDF come Base64-stringa codificata in JSON formato, non come dati binari.

Success Response

Elaborazione sincrona (impostazione predefinita)

Quando async non è impostato o impostato su false, IL API elabora la richiesta immediatamente:

Codice di stato: 200 OK

Content-Type: application/json

Corpo della risposta:

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

Campi di risposta:

• docName (stringa): L'output PDF nome del file
• docContent (stringa): La PDF file con timbro immagine applicato, codificato come Base64 corda

Come si usa:

1. Estrarre il docContent campo dal JSON risposta
2. decodificare il Base64 stringa per ottenere il binario PDF dati
3. Salva o elabora il PDF file secondo necessità

Esempio (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

Elaborazione asincrona

Quando async: true è impostato, il API elabora la richiesta in modo asincrono:

Codice di stato: 202 Accepted

Intestazioni di risposta:

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

Procedura di votazione:

1. Estrarre il Location intestazione dalla risposta 202
2. Sondare il URL utilizzando GET richieste
3. Continua a fare sondaggi finché non ricevi un 200 OK stati
4. La risposta finale contiene lo stesso JSON formato con docName E docContent Base64)

Esempio di sondaggio:

// 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

Risposte di errore

IL API resi standard HTTP Codici di errore con dettagli dell'errore:

400 Bad Request

• Parametri di richiesta non validi
• Campi obbligatori mancanti (docName, docContent, nomeimmagine, file immagine, allineaX, allineamentoY)
• Non valido Base64 codifica in docContent O file immagine
• Valori di allineamento non validi (devono essere: Sinistra/Centro/Destra per allineamentoX, Alto/Centro/Basso per allineamentoY)
• Valori di dimensione o margine non validi (al di fuori degli intervalli consentiti)

401 Unauthorized

• Non valido o mancante API chiave
• API chiave non corretta Base64 codificato in Authorization intestazione
• Mancante Autorizzazione: Base intestazione

500 Internal Server Error

• Errore di elaborazione lato server
• PDF errore di elaborazione
• Errore nell'applicazione del timbro immagine

Formato della risposta di errore:

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

Response Format Details

Dettagli sul formato di risposta

Importante: IL API ritorna sempre JSONmai binario PDF dati direttamente.

Struttura della risposta:

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

Content-Type Intestazione:

• Successo: application/json
• IL PDF è incorporato come un Base64 stringa all'interno della JSON risposta

Perché Base64?

• JSON- codifica sicura per dati binari
• Facile da trasmettere HTTP
• Compatibile con tutti i linguaggi di programmazione
• Può essere incorporato direttamente in JSON senza sfuggire ai problemi

Codifica Base64 A 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);

Esempio di richiesta

Intestazione

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

• Ottieni il tuo API chiave dalla PDF4me Pannello di controllo
• IL API la chiave deve essere Base64 codificato e prefissato con "Basic" nel Authorization intestazione
• Esempio: se il tuo API la chiave è abc123, codificalo in Base64 e utilizzare Authorization: Basic YWJjMTIz

Carico utile

Esempio di base (solo campi obbligatori):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle"
}

Esempio avanzato (con tutti i campi opzionali):

{
  "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
}

Esempi di codice

IL PDF4me Aggiungi timbro immagine a PDF REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:

C#

C# CSharp) Campione

Completo C# implementazione per l'aggiunta di timbri immagine a PDF:

View C# Sample

Java

Java Campione

Java implementazione con gestione completa degli errori ed elaborazione delle risposte:

View Java Sample

JavaScript

JavaScript Campione

Node.js e compatibile con i browser JavaScript implementazione:

View JavaScript Sample

Python

Python Campione

Python implementazione con libreria requests e JSON gestione:

View Python Sample

Salesforce

Salesforce Campione

Salesforce Apex implementazione per CRM integrazione:

View Salesforce Sample

n8n

n8n Campione

n8n Implementazione del flusso di lavoro per l'automazione:

View n8n Sample

Google Script

Google Script Campione

Google Apps Script implementazione per Google Workspace integrazione:

View Google Script Sample

AWS Lambda

AWS Lambda Campione

Senza server AWS Lambda implementazione della funzione:

View AWS Lambda Sample

Casi d'uso e applicazioni industriali

Legal & Professional Services

Casi d'uso per servizi legali e professionali

• Documentazione legaleApplicare clausole di esclusione di responsabilità e avvisi di riservatezza ai documenti legali
• Timbro contrattualeAggiungi timbri immagine a contratti e accordi
• Avvisi di riservatezza: Applicare timbri di riservatezza con immagini a documenti legali sensibili
• Sigilli di conformitàAggiungere avvisi di conformità normativa con immagini ai documenti legali

Business & Enterprise

Casi d'uso aziendali e per le imprese

• Branding del documentoAggiungi loghi aziendali, filigrane ed elementi di branding ai documenti PDF
• Indicatori di statoAggiungere le etichette "BOZZA", "RISERVATO" o "APPROVATO" per indicare lo stato del documento.
• Generazione di reportAggiungi timestamp, numeri di pagina e identificativi del report ai documenti generati
• Branding aziendale: Applicare un'immagine coordinata e coerente a tutti i documenti aziendali

Finance & Banking

Casi d'uso in ambito finanziario e bancario

• Rapporti finanziariAggiungere timbri immagine a report e bilanci finanziari
• Timbro della fattura: Applicare timbri con immagine di approvazione a fatture e ordini di acquisto
• Documentazione di conformitàAggiungere i timbri di conformità normativa ai documenti finanziari
• Tracce di controllo: Creare tracce di controllo con timestamp delle immagini sui documenti finanziari

Government & Compliance

Casi d'uso per la pubblica amministrazione e la conformità normativa.

• Protezione del diritto d'autoreApplicare avvisi di copyright e timbri con immagini di proprietà per proteggere la proprietà intellettuale
• Conformità normativaAggiungere i timbri di conformità per soddisfare i requisiti normativi
• Documentazione ufficiale: Apporre timbri ufficiali con immagine sui documenti governativi
• Registri pubbliciAggiungere timbri di classificazione delle immagini a registri e documenti pubblici

Richiedi assistenza

Get Your API KeyAPI SamplesGetting Started