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, dimensioni personalizzate, 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.
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.
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.
| Parametro | Necessario | Cosa fa | Esempio |
|---|---|---|---|
| jobIdExt | Optional | Your own reference for this call. It is stored with the API call log so you can correlate calls with your jobs. Type: string. | |
| integrations | Optional | Integration identifiers, forwarded unchanged with the job's notification settings. Type: array. | |
| isAsync | Optional | Set to `true` to process the action asynchronously and get a job to poll at `/api/v2/GetActionStatus`. Only honoured by actions that support asynchronous processing. Type: boolean. | true |
| docName | Optional | Source file name including its extension. Several actions dispatch on the extension, so it should always be set; when omitted a per-action default is used. Type: string. | output.pdf |
| docContent | Required | The source file. Accepts the base64-encoded file content, a `pdf4meblobid://<id>` reference to a previously uploaded blob, or an `https` URL to the source document. Required: an empty value fails with `File is empty`. Type: string. | JVBERi... |
| docContentBytes | Optional | Alternative raw byte payload for the source file. Type: string. | |
| callBackUrl | Optional | Optional URL notified when an asynchronous job completes. Type: string. | |
| imageName | Optional | Required. File name of the stamp image including its extension (e.g. `logo.png`); the extension sets the image type. Type: string. | stamp.png |
| imageFile | Optional | Required. The stamp image. Accepts the base64-encoded file content, a `pdf4meblobid://<id>` reference, or an `https` URL. Type: string. | iVBORw0KGgoAAAANS... |
| alignX | Optional | An unrecognised value is rejected with 400. Type: string. | Center |
| alignY | Optional | An unrecognised value is rejected with 400. Type: string. | Middle |
| heightInMM | Optional | Image height in millimetres. When `heightInMM` or `widthInMM` is set it overrides the `...InPx` size. If only one dimension is given the other keeps the image's aspect ratio; if none is given the image's own size is used. Type: string. | 30 |
| widthInMM | Optional | Image width in millimetres. When `heightInMM` or `widthInMM` is set it overrides the `...InPx` size. If only one dimension is given the other keeps the image's aspect ratio. Type: string. | 30 |
| heightInPx | Optional | Image height in points (1/72 inch), despite the name. Ignored when a millimetre size is given. Type: string. | 85 |
| widthInPx | Optional | Image width in points (1/72 inch), despite the name. Ignored when a millimetre size is given. Type: string. | 85 |
| marginXInMM | Optional | Horizontal distance in millimetres from the edge chosen by `alignX`. Overrides `marginXInPx` when either millimetre margin is set. Ignored when `alignX` is `center`. Type: string. | 10 |
| marginYInMM | Optional | Vertical distance in millimetres from the edge chosen by `alignY`. Overrides `marginYInPx` when either millimetre margin is set. Ignored when `alignY` is `middle`. Type: string. | 10 |
| marginXInPx | Optional | Horizontal distance in points (1/72 inch, despite the name) from the edge chosen by `alignX`. Ignored when `alignX` is `center`. Type: string. | 28 |
| marginYInPx | Optional | Vertical distance in points (1/72 inch, despite the name) from the edge chosen by `alignY`. Ignored when `alignY` is `middle`. Type: string. | 28 |
| opacity | Optional | Opacity from `0` (invisible) to `100` (fully opaque); values outside the range are clamped. Omitted or non-numeric counts as `0`, so always set it. Type: string. | 50 |
| pages | Optional | Pages to stamp, e.g. `1`, `1,3,5`, `2-5` or `2-` (2 to the last page). Type: string. | ""` or `"1-3" |
| showOnlyInPrint | Optional | Show the stamp only when the PDF is printed, not on screen. Only used by ImageStamp; SignPdf ignores it. Type: boolean. | false |
| isBackground | Optional | Place the stamp behind the page content instead of in front. Ignored when `showOnlyInPrint` is `true`. Only used by ImageStamp; SignPdf ignores it. Type: boolean. | 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
- Asynchronous Processing
- Error Responses
- Response Format Details
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:
- Estrarre il
docContentcampo dal JSON risposta - decodificare il Base64 stringa per ottenere il binario PDF dati
- 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
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:
- Estrarre il
Locationintestazione dalla risposta 202 - Sondare il URL utilizzando GET richieste
- Continua a fare sondaggi finché non ricevi un 200 OK stati
- La risposta finale contiene lo stesso JSON formato con
docNameEdocContentBase64)
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
}
Risposte di errore
IL API resi standard HTTP Codici di errore con dettagli dell'errore:
- Parametri di richiesta non validi
- Campi obbligatori mancanti (
docName,docContent,nomeimmagine,file immagine,allineaX,allineamentoY) - Non valido Base64 codifica in
docContentOfile 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)
- Non valido o mancante API chiave
- API chiave non corretta Base64 codificato in Authorization intestazione
- Mancante
Autorizzazione: Baseintestazione
- 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"
}
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 utilizzareAuthorization: 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#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# CSharp) Campione
Completo C# implementazione per l'aggiunta di timbri immagine a PDF:
Java Campione
Java implementazione con gestione completa degli errori ed elaborazione delle risposte:
JavaScript Campione
Node.js e compatibile con i browser JavaScript implementazione:
Google Script Campione
Google Apps Script implementazione per Google Workspace integrazione:
Casi d'uso e applicazioni industriali
- Legal & Professional Services
- Business & Enterprise
- Finance & Banking
- Government & Compliance
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
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
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
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