API V2

Aggiungi codice a barre al PDF

Trasforma i tuoi documenti PDF con la nostra potente API di codici a barre che supporta oltre 150 tipi di codici a barre, inclusi QR Code, Code128, DataMatrix, Aztec, Hanxin e PDF417. Perfetta per sistemi di inventario, etichette di spedizione, tracciamento documenti e workflow automatizzati.

Caratteristiche principali:

  • 150+ tipi di codici a barre: QR Code, Code128, DataMatrix, Aztec, Hanxin, PDF417 e altro
  • Posizionamento flessibile: Posiziona i codici a barre ovunque sul tuo PDF con controllo preciso
  • Formati multipli: Supporto per millimetri e punti per dimensionamento preciso
  • Opzioni di visualizzazione testo: Mostra o nascondi il testo del codice a barre, posiziona sopra o sotto
  • Controllo opacità: Regola la trasparenza per effetti filigrana
  • Elaborazione batch: Aggiungi codici a barre a più pagine o documenti

Casi d’uso popolari:

  • E-commerce: Cataloghi di prodotti con etichette a barre
  • Logistica: Etichette di spedizione e documenti di tracciamento
  • Sanità: Cartelle cliniche e somministrazione di farmaci
  • Governo: Documenti di identità e moduli di conformità
  • Istruzione: Tessere studente e sistemi bibliotecari

Questa API generatore di codici a barre si integra perfettamente con i tuoi flussi di lavoro esistenti, offrendo affidabilità e prestazioni di livello aziendale.

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

Autenticare la tua richiesta API

Per accedere all’API Web di PDF4me, ogni richiesta deve includere le credenziali di autenticazione appropriate. L’autenticazione garantisce una comunicazione sicura e valida la tua identità come utente autorizzato.


Tipi di codici a barre supportati

La nostra API generatore di codici a barre supporta 150+ tipi di codici a barre, rendendola la soluzione più completa per l’integrazione di codici a barre PDF.

Codici a barre 1D (Lineari)

  • Code128: Codice a barre 1D più versatile, supporta tutti i caratteri ASCII
  • Code39: Codice a barre alfanumerico, ampiamente utilizzato in logistica
  • EAN13/EAN8: Identificazione internazionale dei prodotti retail
  • UPC-A/UPC-E: Standard retail nordamericano
  • Code93: Versione migliorata di Code39 con migliore densità

Codici a barre 2D (Matrice)

  • Codice QR: Codice a barre 2D più popolare per la scansione mobile
  • DataMatrix: Codice a barre 2D ad alta densità, perfetto per articoli piccoli
  • PDF417: Codice a barre lineare impilato con grande capacità di dati
  • Aztec: Codice a barre 2D con eccellente correzione degli errori
  • Hanxin: Standard nazionale cinese per codici a barre 2D

PDF4me api samples

CSharp(C#)
Java
JavaScript
Python
Salesforce
Google Script
AWS Lambda

Parametri API

Elenco completo dei parametri per l’API Add Barcode to PDF. I parametri sono organizzati per categoria per una migliore comprensione e implementazione.

Contenuto del documentoBase64, Required

Il contenuto del documento PDF codificato in formato Base64. Questo è il file PDF sorgente a cui verranno aggiunti i codici a barre. Il file deve essere un documento PDF valido.

Esempio:JVBERi0xLjQKJcOkw7zDtsO8CjIgMCBvYmoKPDwKL0xlbmd0aCAzIDAgUgo+PgpzdHJlYW0K...

Nome del documentostring, Required

Il nome del file PDF sorgente. Deve includere l’estensione .pdf. Questo nome verrà utilizzato per riferimento e può apparire nei messaggi di errore.

Esempi:

  • document.pdf
  • invoice-2024.pdf
  • report-final.pdf
Dati del codice a barrestring, Required

I dati da codificare nel codice a barre. Può essere testo, numeri, URL o qualsiasi stringa supportata dal tipo di codice a barre selezionato. I dati verranno convertiti in un’immagine di codice a barre scansionabile.

Esempi:

  • Testo:Hello World
  • URL:https://example.com
  • Codice prodotto:ABC123456
  • Telefono:+1-555-123-4567

Nota: Diversi tipi di codici a barre hanno limiti di capacità dati e restrizioni di caratteri diversi.

Tipo di codice a barrestring, Required

Specifica il tipo di codice a barre da generare. Scegli tra oltre 150 formati di codici a barre supportati, inclusi codici QR, codici a barre lineari e codici matriciali 2D.

Tipi popolari:

  • Codice QR:qrCode - Codice a barre 2D più versatile
  • Code128:code128 - Codice a barre 1D universale
  • DataMatrix:dataMatrix - Codice a barre 2D ad alta densità
  • EAN13:ean13 - Codice prodotto internazionale
  • UPC-A:upcA - Standard retail nordamericano

Vedi l’elenco completo dei tipi di codici a barre supportati sopra per tutte le opzioni disponibili.

Pagine di destinazionestring, Required

Specifica quali pagine devono avere codici a barre aggiunti. Usa selezione flessibile delle pagine con valori separati da virgole e intervalli.

Esempi di formato:

  • Tutte le pagine:"" (stringa vuota)
  • Pagina singola:"0" (prima pagina)
  • Pagine multiple:"0, 2, 4"
  • Intervallo di pagine:"1-5" (pagine 2-6)
  • Misto:"0, 2-4, 7" (pagina 1, pagine 3-5, pagina 8)
  • Dalla pagina alla fine:"3-" (pagina 4 alla fine)

Nota: Gli indici delle pagine sono basati su 0 (prima pagina = 0). Se non specificato, i codici a barre vengono aggiunti a tutte le pagine.

Allineamento orizzontalestring, Required

Controlla il posizionamento orizzontale del codice a barre sulla pagina. Questo determina dove appare il codice a barre orizzontalmente rispetto ai margini della pagina.

Opzioni:

  • Left - Allinea al bordo sinistro della pagina
  • Center - Centra orizzontalmente sulla pagina
  • Right - Allinea al bordo destro della pagina

Esempio:"Center" posizionerà il codice a barre al centro della pagina orizzontalmente.

Allineamento verticalestring, Required

Controlla il posizionamento verticale del codice a barre sulla pagina. Questo determina dove appare il codice a barre verticalmente rispetto ai margini della pagina.

Opzioni:

  • Top - Allinea al bordo superiore della pagina
  • Middle - Centra verticalmente sulla pagina
  • Bottom - Allinea al bordo inferiore della pagina

Esempio:"Bottom" posizionerà il codice a barre in fondo alla pagina verticalmente.

Altezza del codice a barre (mm)string, Required

Imposta l’altezza del codice a barre in millimetri. Questo controlla la dimensione verticale del codice a barre generato.

Altezze raccomandate:

  • Codici QR: 20-60mm (40mm raccomandato)
  • Codici a barre 1D: 15-30mm (20mm raccomandato)
  • DataMatrix: 10-40mm (20mm raccomandato)

Ridimensionamento automatico: Inserisci "0" per lasciare che il sistema determini automaticamente l’altezza ottimale basata sul tipo di codice a barre e sui dati.

Esempio:"40" crea un codice a barre alto 40mm.

Larghezza in mmstring, Required

Larghezza del codice a barre in millimetri. ‘0’ per il rilevamento automatico.
Esempio - 40.

Margine orizzontale in mmstring, Required

Margine dall’origine sinistra del codice a barre in millimetri
Esempio - 20

Margine verticale in mmstring, Required

Margine dall’origine superiore del codice a barre in millimetri
Esempio - 20

Altezza in PtString, Required

Altezza del codice a barre in punti (pt). o ‘0’ per il rilevamento automatico.
Esempio - 20.

Larghezza in PtString, Required

Larghezza del codice a barre in punti (pt). o ‘0’ per il rilevamento automatico.
Esempio - 20.

Margine X in PtString, Required

Margine dall’origine superiore del codice a barre in punti (pt).
Esempio - 10.

Margine Y in PtString, Required

Margine dall’origine sinistra del codice a barre in punti (pt).
Esempio - 10.

Opacitàinteger, Required

Dai un valore tra 0 e 100 dove ‘0’ è completamente trasparente.
Esempio - 100.

Mostrare il testoString, Required

Il testo sarà visualizzato -
sopra
sotto

Nascondere il testoBoolean, Required

Seleziona ‘true’ per nascondere il testo del codice a barre e ‘false’ per visualizzarlo accanto al codice a barre.

  • true
  • false
Mostrare solo in stampaBoolean, Required

Se vuoi Mostrare solo in stampa, mostra solo in stampa. Puoi scegliere queste due opzioni.
true
false

Il testo è sopraBoolean, Required

Se vuoi Il testo è sopra, puoi scegliere queste due opzioni.
true
false


Output

L’API restituisce il documento PDF elaborato con codici a barre incorporati. La risposta include il contenuto del file e i metadati per una facile integrazione nel flusso di lavoro dell’applicazione.

Contenuto del fileBinary

Contenuto binario del documento PDF elaborato con codici a barre incorporati. Pronto per il download o l’elaborazione successiva.

Nome del fileString

Nome del file per il documento PDF elaborato. Può essere personalizzato o generato automaticamente in base alle tue esigenze.

Intestazione
Content-Type: application/json
Authorization: Copia la chiave dal link.

Payload

{
  "alignX": "Right",
  "alignY": "Top",
  "docContent": "Please put PDF base64 content",
  "docName": "output.pdf",
  "text": "hello",
  "barcodeType": "qrCode",
  "pages": "2",
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "20",
  "widthInPt": "20",
  "marginXInPt": "10",
  "marginYInPt": "10",
  "opacity": 100,
  "displayText": "above",
  "hideText": true,
  "showOnlyInPrint": false,
  "isTextAbove": true
}

Casi d’uso industriali e applicazioni

E-commerce e retail

  • Cataloghi prodotti: Generare codici a barre per gestione inventario e identificazione prodotti
  • Etichette prezzi: Creare prezzi dinamici con integrazione codici a barre per checkout automatizzato
  • Tracciamento ordini: Aggiungere codici di tracciamento a documenti di spedizione per monitoraggio tempo reale
  • Sistemi inventario: Generazione di massa codici a barre per gestione magazzino

Logistica e spedizioni

  • Etichette spedizione: Aggiungere codici a barre di tracciamento a documenti di consegna
  • Tracciamento pacchi: Generare identificatori unici per ogni spedizione nella catena di fornitura
  • Gestione magazzino: Creare codici a barre per ubicazioni e identificazione prodotti
  • Catena di fornitura: Tracciare prodotti attraverso tutta la rete di distribuzione

Sanità e medica

  • Cartelle pazienti: Aggiungere codici a barre per identificazione rapida pazienti
  • Somministrazione farmaci: Generare codici a barre per tracciamento farmaci
  • Attrezzature mediche: Etichettare attrezzature con codici a barre di manutenzione
  • Risultati laboratorio: Aggiungere codici a barre a documenti risultati

🏛️ Governo e conformità

  • Documenti identità: Aggiungere codici a barre di sicurezza a patenti e passaporti
  • Documenti fiscali: Generare codici di tracciamento per moduli fiscali
  • Moduli conformità: Aggiungere codici a barre per tracciamento normativo
  • Registri pubblici: Creare identificatori documenti ricercabili

🎓 Educazione e biblioteche

  • Tessere studente: Generare codici a barre per identificazione studenti
  • Sistemi biblioteca: Aggiungere codici a barre a libri e risorse
  • Documenti esame: Creare identificatori unici per test
  • Servizi campus: Tracciare uso attrezzature e risorse

💼 Azienda e finanza

  • Elaborazione fatture: Aggiungere codici a barre per gestione automatizzata fatture
  • Gestione documenti: Creare identificatori unici per documenti aziendali
  • Tracciamento asset: Generare codici a barre per attrezzature e asset
  • Piste di audit: Aggiungere codici di tracciamento per documentazione conformità