Passa al contenuto principale

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.

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.

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.

ParametroNecessarioCosa faEsempio
jobIdExtOptionalYour own reference for this call. It is stored with the API call log so you can correlate calls with your jobs. Type: string.
integrationsOptionalIntegration identifiers, forwarded unchanged with the job's notification settings. Type: array.
isAsyncOptionalSet 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
docNameOptionalSource 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
docContentRequiredThe 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...
docContentBytesOptionalAlternative raw byte payload for the source file. Type: string.
callBackUrlOptionalOptional URL notified when an asynchronous job completes. Type: string.
imageNameOptionalRequired. File name of the stamp image including its extension (e.g. `logo.png`); the extension sets the image type. Type: string.stamp.png
imageFileOptionalRequired. The stamp image. Accepts the base64-encoded file content, a `pdf4meblobid://<id>` reference, or an `https` URL. Type: string.iVBORw0KGgoAAAANS...
alignXOptionalAn unrecognised value is rejected with 400. Type: string.Center
alignYOptionalAn unrecognised value is rejected with 400. Type: string.Middle
heightInMMOptionalImage 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
widthInMMOptionalImage 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
heightInPxOptionalImage height in points (1/72 inch), despite the name. Ignored when a millimetre size is given. Type: string.85
widthInPxOptionalImage width in points (1/72 inch), despite the name. Ignored when a millimetre size is given. Type: string.85
marginXInMMOptionalHorizontal 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
marginYInMMOptionalVertical 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
marginXInPxOptionalHorizontal distance in points (1/72 inch, despite the name) from the edge chosen by `alignX`. Ignored when `alignX` is `center`. Type: string.28
marginYInPxOptionalVertical distance in points (1/72 inch, despite the name) from the edge chosen by `alignY`. Ignored when `alignY` is `middle`. Type: string.28
opacityOptionalOpacity 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
pagesOptionalPages to stamp, e.g. `1`, `1,3,5`, `2-5` or `2-` (2 to the last page). Type: string.""` or `"1-3"
showOnlyInPrintOptionalShow the stamp only when the PDF is printed, not on screen. Only used by ImageStamp; SignPdf ignores it. Type: boolean.false
isBackgroundOptionalPlace 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.

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

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# CSharp) Campione

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

Casi d'uso e applicazioni industriali​

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

Richiedi assistenza​