Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Cartello PDF - Firma digitale API

PDF4me Cartello PDF ti consente di aggiungere immagini della firma a PDF documenti con controllo su posizione, dimensione e aspetto. Questo API processi di servizio PDF file e aggiunge immagini di firma utilizzando Base64 codifica per la trasmissione sicura. API riceve PDF dati relativi al contenuto e all'immagine della firma tramite REST API chiamate. Questa soluzione è ideale per l'autenticazione dei documenti, la conformità legale, i flussi di lavoro aziendali e l'aggiunta di firme visive ai documenti.

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 la firma immagine: Aggiungi immagini di firma personalizzate a PDF documenti con pieno controllo su posizionamento e dimensionamento
  • Posizionamento flessibile: Controllo dell'allineamento orizzontale e verticale con precisione al pixel
  • Dimensioni personalizzateRegola le dimensioni della firma utilizzando sia le misurazioni in millimetri che in pixel.
  • Formattazione avanzataImposta opacità, margini e opzioni di sfondo per un aspetto professionale.
  • Targeting della pagina: Applicare le firme a pagine specifiche o a interi documenti
  • Controllo di stampaConfigura le firme in modo che vengano visualizzate solo in stampa o solo a schermo
  • Risultati professionali: Creare firme che migliorino l'autenticazione e la sicurezza dei documenti
  • 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. Tutti PDF Le operazioni di firma vengono eseguite tramite un unico endpoint:

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

Supportato PDF Funzionalità di firma​

IL API fornisce un supporto completo per vari PDF funzionalità di firma:

Supporto per l'immagine della firma​

  • Formati comuni: Supporto per JPG, PNGe altri formati di immagine standard
  • Base64 Codifica: Trasmissione sicura della firma tramite Base64 codifica
  • Taglie flessibili: Opzioni di dimensionamento basate sia su millimetri (10-200 mm) che su pixel (20-600 pixel).
  • Conservazione della qualità: Mantiene la qualità dell'immagine della firma in PDF produzione

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 (0-100 mm) che in pixel (0-300 px).
  • Inserimento flessibileSupporto per qualsiasi posizione della pagina con misurazioni precise
  • Targeting della pagina: Applica a pagine specifiche o a interi documenti (facoltativo)

Funzionalità avanzate​

  • Controllo dell'opacitàTrasparenza regolabile (0-100) per firme discrete o evidenti
  • Modalità in backgroundOpzione per posizionare le firme dietro o davanti al contenuto
  • Controllo di stampaConfigura le firme in modo che vengano visualizzate e stampate oppure solo stampate.
  • Aspetto professionale: Rendering della firma di alta qualità con chiara visibilità

REST API Parametri​

Elenco completo dei parametri per il Segno 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*StringProduzione PDF nome del file con estensione .pdfoutput.pdf
docContent*Base64PDF contenuto del file codificato in Base64JVBERi...
file immagine*Base64Contenuto del file immagine della firma codificato in Base64iVBORw0KGgoAAAANSUhEUgAA...
nomeimmagine*StringNome del file immagine della firma con estensione (ad esempio, .jpg, .png)signature.jpg
allineaX*StringAllineamento orizzontale: Sinistra, Centro, O GiustoRight
allineamentoY*StringAllineamento verticale: Superiore, Mezzo, O Metter il fondo aBottom

Parametri opzionali​

ParametroTipoDescrizioneEsempio
pagineStringOpzioni pagina: "1", "1,3,5", "2-5", "1,3,7-10", "2-". Se non specificato, si applica a tutte le pagine.1-3
larghezzaInMMStringLarghezza della firma in millimetri (10-200)50
altezza in mmStringAltezza della firma in millimetri (10-200)25
larghezzaInPxStringLarghezza della firma in pixel (20-600)142
altezzaInPxStringAltezza della firma in pixel (20-600)71
marginXInMMStringMargine orizzontale in millimetri (0-100)20
marginYInMMStringMargine verticale in millimetri (0-100)20
marginXInPxStringMargine orizzontale in pixel (0-300)57
marginYInPxStringMargine verticale in pixel (0-300)57
opacitàStringOpacità (0-100): 0=invisibile, 100=completamente opaco100
mostra solo in formato cartaceoBooleanMostra la firma in vista e stampala (vero) oppure stampala soltanto (falso)true
è lo sfondoBooleanPosiziona la firma sullo sfondo (vero) o in primo piano (falso)false
asincronoBooleanAbilita l'elaborazione asincrona. Quando true, IL API restituisce uno stato 202 e fornisce un polling URL nel Location intestazionetrue

Produzione​

IL PDF4me Cartello 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 firma aggiunta, 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==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "alignX": "Right",
  "alignY": "Bottom"
}

Esempio avanzato (con tutti i campi opzionali):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "widthInMM": "50",
  "heightInMM": "25",
  "widthInPx": "142",
  "heightInPx": "71",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "marginXInPx": "57",
  "marginYInPx": "57",
  "opacity": "100",
  "showOnlyInPrint": true,
  "isBackground": false,
  "async": true
}

Esempi di codice​

IL PDF4me Cartello 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 la firma PDF Documenti:

PDF Funzionalità di firma​

Controllo dell'immagine della firma​

  • Supporto formato: JPG, PNG, GIF e altri formati di immagine standard
  • Conservazione della qualità: Mantiene la qualità e la risoluzione dell'immagine della firma in PDF produzione
  • Base64 Codifica: Trasmissione sicura della firma tramite Base64 codifica
  • Taglie flessibili: Opzioni di dimensionamento sia in millimetri che in pixel
  • Aspetto professionale: Rendering della firma 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
  • Inserimento flessibileSupporto per qualsiasi posizione e orientamento della pagina
  • Targeting della pagina: Applicabile a pagine specifiche o a interi documenti
  • Controllo delle dimensioniDimensioni personalizzabili per un posizionamento ottimale

Funzionalità avanzate​

  • Controllo dell'opacitàTrasparenza regolabile per firme discrete o evidenti
  • Modalità in backgroundOpzione per posizionare le firme dietro o davanti al contenuto
  • Controllo di stampaConfigura le firme in modo che vengano visualizzate solo in stampa o solo a schermo
  • Risultati professionali: Creare firme che migliorino l'autenticazione e la sicurezza dei documenti
  • Posizionamento flessibile: Controllo dell'allineamento orizzontale e verticale con precisione al pixel

Casi d'uso e applicazioni industriali​

Casi d'uso per servizi legali e professionali

  • Documentazione legaleApporre firme su contratti legali, accordi e documenti ufficiali.
  • Firma del contrattoFirma contratti e accordi in formato digitale per la loro validità legale.
  • Documenti del tribunale: Applicare firme digitali ad atti giudiziari e documenti legali
  • Requisiti di conformità: Soddisfare i requisiti normativi per la firma e l'autenticazione dei documenti

Richiedi assistenza​

Get Your API KeyAPI SamplesGetting Started