Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Aggiungi timbro di testo a PDF - Filigrana di testo API

PDF4me Aggiungi timbro di testo a PDF consente di aggiungere filigrane di testo personalizzabili a PDF documenti per l'autorizzazione e la prevenzione della pirateria. Questo API processi di servizio PDF file e aggiunge timbri di testo con controllo su testo, posizione, stile, rotazione e aspetto. Il API riceve PDF contenuto attraverso REST API chiamate, utilizzando Base64 codifica per trasmissione sicura. Questa soluzione è ideale per branding dei documenti, protezione del copyright, indicatori di stato e 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​

  • Posizionamento flessibile: Controllo dell'allineamento orizzontale e verticale con precisione al pixel
  • Stile personalizzatoScegli tra vari caratteri, dimensioni, colori ed effetti di testo (grassetto, corsivo, sottolineato).
  • Formattazione avanzataImposta opacità, rotazione, margini e opzioni di sfondo
  • 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: Creare filigrane che migliorino la sicurezza dei documenti e l'immagine del marchio
  • Elaborazione asincronaSupporto per l'elaborazione asincrona con polling per operazioni di lunga durata

REST API Punto finale​

IL PDF4me REST API utilizza standard HTTP metodi per interagire con le risorse. Tutte le operazioni di aggiunta di testo vengono eseguite tramite un unico endpoint:

  • Metodo: INVIARE
  • Punto finale: /api/v2/Stamp

Funzionalità di stampa del testo supportate​

IL API offre un supporto completo per varie funzionalità di stampa e filigrana del testo:

Opzioni di personalizzazione del testo​

  • Selezione del carattere: Scegli tra Arial, Times New Roman, Helvetica o Courier New
  • Controllo delle dimensioni: Dimensione del carattere regolabile da 8 a 72
  • Opzioni di coloreSupporto completo dello spettro cromatico con codici colore esadecimali (ad esempio, #FF0000 per il rosso).
  • Effetti di testoOpzioni di formattazione: grassetto, corsivo e sottolineato
  • Testo personalizzatoSupporto per qualsiasi contenuto testuale, inclusi simboli e caratteri speciali.

Posizionamento e disposizione​

  • Allineamento orizzontaleOpzioni di posizionamento: sinistra, centro e destra
  • Allineamento verticaleControllo del posizionamento in alto, al centro e in basso
  • Controllo dei marginiPosizionamento preciso con misurazioni sia in millimetri che in pixel.
  • Supporto di rotazioneRotazione del testo: 0 (orizzontale), 45 (diagonale), 90 (verticale), -45 (diagonale inversa)
  • Inserimento flessibileSupporto per qualsiasi posizione della pagina con misurazioni precise

Funzionalità avanzate​

  • Controllo dell'opacitàTrasparenza regolabile (0-100) per filigrane discrete o evidenti
  • Modalità in backgroundOpzione per posizionare il testo dietro o davanti al contenuto
  • Controllo di stampaConfigura i timbri in modo che vengano visualizzati e stampati oppure solo stampati.
  • Targeting della pagina: Applicabile a pagine specifiche o a interi documenti
  • Adattamento del testo: Ridimensionamento automatico del testo per adattarlo ai margini della pagina (opzionale)

REST API Parametri​

Elenco completo dei parametri per Aggiungi timbro di testo 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​

ParametroTipoDescrizioneEsempio
docName*CordaProduzione PDF nome del file con estensione .pdfoutput.pdf
docContent*Base64PDF contenuto del file codificato in Base64JVBERi...
pagine*CordaOpzioni pagina: "tutte", "1", "1,3,5", "2-5", "1,3,7-10", "2-"all
testo*CordaTesto da stampare come filigranaCONFIDENTIAL - PDF4me Watermark
allineaX*CordaAllineamento orizzontale: Sinistra, centro, O Giustocenter
allineamentoY*CordaAllineamento verticale: superiore, mezzo, O metter il fondo amiddle

Parametri opzionali​

ParametroTipoDescrizioneEsempio
marginXInMMCordaMargine orizzontale dal bordo sinistro in millimetri50
marginYInMMCordaMargine verticale dal bordo superiore in millimetri50
marginXInPxCordaMargine orizzontale dal bordo sinistro in pixel150
marginYInPxCordaMargine verticale dal bordo superiore in pixel150
opacitàCordaOpacità (0-100): 0=invisibile, 100=completamente opaco30
nome del carattereCordaNome del carattere: Arial, Times New Roman, Helvetica, Corriere NuovoArial
dimensione del carattereInteroDimensione del carattere (8-72)24
fontColorCordaColore del carattere in formato esadecimale (ad esempio, #FF0000 per il rosso)#FF0000
Palla di ghiaccioBooleanoRendi il testo in grassetto (vero) o normale (falso)true
corsivoBooleanoRendi il testo corsivo (vero) o normale (falso)false
sottolineareBooleanoSottolinea il testo (vero) o non (falso)false
ruotareInteroAngolo di rotazione: 0 (orizzontale), 45 (diagonale), 90 (verde), -45 (diagonale inversa)45
è lo sfondoBooleanoPosiziona il timbro sullo sfondo (vero) o in primo piano (falso)true
mostra solo in formato cartaceoBooleanoMostra il francobollo e stampalo (falso) oppure stampalo soltanto (vero)false
trasversaleBooleanoPosizionamento trasversale (vero) o normale (falso)false
fitTextOverPageBooleanoAdatta il testo all'intera pagina (vero) o utilizza le dimensioni specificate (falso)false
asincronoBooleanoAbilita l'elaborazione asincrona. Quando true, IL API restituisce uno stato 202 e fornisce un polling URL nel Location intestazionetrue

Produzione​

IL PDF4me Aggiungi timbro di testo 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 di testo aggiunto, 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==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle"
}

Esempio avanzato (con tutti i campi opzionali):

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

Esempi di codice​

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

C# Esempio (CSharp)

Completo C# implementazione per aggiungere timbri di testo a PDF:

Caratteristiche di stampa del testo​

Opzioni di personalizzazione​

  • Controllo del carattereDiverse famiglie di caratteri con possibilità di personalizzazione di dimensioni e colori.
  • Effetti di testoOpzioni di formattazione: grassetto, corsivo e sottolineato
  • Gestione del coloreSupporto completo dello spettro cromatico con codici esadecimali
  • Contenuto testualeSupporto per qualsiasi testo, inclusi simboli e caratteri speciali.
  • Styling professionale: Rendering del testo di alta qualità con chiara visibilità

Posizionamento e disposizione​

  • Controllo dell'allineamentoOpzioni di allineamento orizzontale e verticale precise
  • Impostazioni dei margini: Posizionamento sia in millimetri che in pixel
  • Supporto di rotazioneRotazione del testo per filigrane diagonali o angolate
  • Inserimento flessibileSupporto per qualsiasi posizione e orientamento della pagina
  • Targeting della pagina: Applicabile a pagine specifiche o a interi documenti

Funzionalità avanzate​

  • Controllo dell'opacitàTrasparenza regolabile per filigrane discrete o evidenti
  • Modalità in backgroundOpzione per posizionare il testo dietro o davanti al contenuto
  • Controllo di stampaConfigura i timbri in modo che vengano visualizzati solo in stampa o a schermo
  • Adattamento del testo: Ridimensionamento automatico del testo per adattarlo ai bordi della pagina
  • Modalità trasversale: Applicare i timbri su tutta la pagina

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 contrattuale: Aggiungi timbri di stato a contratti e accordi
  • Avvisi di riservatezza: Apporre timbri di riservatezza sui documenti legali sensibili
  • Timbri di conformitàAggiungere avvisi di conformità normativa ai documenti legali

Richiedi assistenza​

Get Your API KeyAPI SamplesGetting Started