Aggiungi il codice a barre a PDF - QR Code Integrazione API

PDF4me Aggiungi il codice a barre a PDF ti consente di aggiungere codici a barre professionali e QR codes A PDF documenti con controlli precisi di posizionamento, dimensionamento e formattazione. Questo API processi di servizio PDF file e aggiunge codici a barre utilizzando Base64 codifica per una trasmissione sicura. Con supporto per oltre 150 tipi di codici a barre, tra cui QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417Grazie alla sua versatilità e alla disponibilità di formati specializzati, questa soluzione è ideale per sistemi di gestione dell'inventario, automazione delle etichette di spedizione, flussi di lavoro di tracciamento dei documenti e integrazione dei codici a barre aziendali.

Articoli correlati del blog(1)

Hai difficoltà ad aggiungere codici a barre ai PDF? Ecco la soluzione completa!

Una guida pratica per aggiungere codici a barre e codici QR ai documenti PDF tramite programmazione. Scopri i tipi di codici a barre, le strategie di posizionamento e gli esempi di implementazione reali.

Leggi il post →

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 completo per i codici a barre: Oltre 150 tipi di codici a barre inclusi QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417codici postali e formati specializzati del settore
• Controllo di posizionamento preciso: Posiziona i codici a barre ovunque su PDF pagine con precisione al pixel utilizzando sia sistemi di misurazione millimetrici che puntuali
• Opzioni di dimensionamento avanzateDimensioni flessibili del codice a barre con funzionalità di ridimensionamento automatico e controlli personalizzati di larghezza/altezza per prestazioni di scansione ottimali.
• Gestione professionale dei testiConfigura la visualizzazione del testo del codice a barre, il posizionamento (sopra/sotto) e la visibilità con opzioni di formattazione personalizzabili.
• Opacità e trasparenzaRegola i livelli di trasparenza del codice a barre per effetti filigrana, sovrapposizioni di documenti e presentazioni professionali.
• Elaborazione batch aziendaleAggiungi codici a barre a più pagine, documenti o intere raccolte di documenti con flussi di lavoro di elaborazione automatizzati.

REST API Punto finale

IL PDF4me REST API utilizza standard HTTP Metodi per interagire con le risorse. Tutte le operazioni sui codici a barre vengono eseguite tramite un unico endpoint:

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

Tipi di codice a barre supportati

Supporta oltre 150 tipi di codici a barre per una copertura completa PDF integrazione.

Codici a barre 1D popolari

• Code128 - Codice a barre universale (massimo 255 caratteri)
• Code39 - Codice a barre alfanumerico (massimo 43 caratteri)
• EAN13/EAN8 - Codici prodotto al dettaglio (13/8 caratteri)
• UPC-A/UPC-E - Vendita al dettaglio nordamericana (12/8 caratteri)

Codici a barre 2D più diffusi

• QR Code - Scansione da dispositivo mobile (massimo 4.296 caratteri)
• DataMatrix - 2D ad alta densità (massimo 2.335 caratteri)
• PDF417 - Ampia capacità di archiviazione (massimo 2.710 caratteri)
• Aztec - Eccellente correzione degli errori (massimo 3.832 caratteri)

Formati specializzati

• Codici postali: USPS, Royal Mail, Australia Post, Deutsche Post
• Assistenza sanitaria: HIBC, GS1 DataBar, Pharmacode
• Logistica: MaxiCode, SSCC-18, ITF-14, GS1-128
• Varianti QR: Micro QR, iQR, rMQR

REST API Parametri

Elenco completo dei parametri per Aggiungi codice a barre 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

Parametro	Tipo	Descrizione	Esempio
docName*	String	Produzione PDF nome del file con estensione .pdf	output.pdf
docContent*	Base64	Il contenuto dell'input PDF file codificato in Base64	JVBERi...
testo*	String	Testo da codificare nel codice a barre. La lunghezza del testo dipende dal tipo di codice a barre.	PDF4me Barcode Sample
barcodeType*	String	Tipo di formato del codice a barre. Opzioni: qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcE	qrCode
pagine*	String	Pagine di destinazione (ad esempio, "1-3", "tutte", "1", "1,3,5", "2-5", "1,3,7-10", "2-")	1-3
alignX*	String	Allineamento orizzontale: Sinistra, Centro, O Giusto	Right
alignY*	String	Allineamento verticale: Superiore, Mezzo, O Metter il fondo a	Bottom
hideText*	Boolean	Nascondi l'etichetta del testo del codice a barre (true=nascondi, false=mostra il testo accanto al codice a barre)	true

Parametri opzionali

Parametro	Tipo	Descrizione	Esempio
heightInMM	String	Altezza del codice a barre in millimetri (0 = automatico)	40
widthInMM	String	Larghezza del codice a barre in millimetri (0 = automatico)	40
marginXInMM	String	Margine orizzontale in millimetri	20
marginYInMM	String	Margine verticale in millimetri	20
heightInPt	String	Altezza del codice a barre in punti	113
widthInPt	String	Larghezza del codice a barre in punti	113
marginXInPt	String	Margine orizzontale in punti	57
marginYInPt	String	Margine verticale in punti	57
opacity	Integer	Livello di trasparenza (0-100): 0=invisibile, 100=completamente opaco	100
displayText	String	Posizione del testo: Sopra O sotto	below
showOnlyInPrint	Boolean	Mostra solo in stampa (vero) o visualizza e stampa (falso)	false
isTextAbove	Boolean	Testo sopra il codice a barre (vero) o sotto (falso)	false
async	Boolean	Abilita l'elaborazione asincrona. Quando true, IL API restituisce uno stato 202 e fornisce un polling URL nel Location intestazione	true

Produzione

IL PDF4me Aggiungi il codice a barre 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

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 codice a barre 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

Asynchronous Processing

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/addbarcode/poll/12345-abcde-67890

Procedura di votazione:

1. Estrarre il Location intestazione dalla risposta 202
2. Sondare il URL utilizzando GET richieste
3. Continua a fare sondaggi finché non ricevi un 200 OK stati
4. La risposta finale contiene lo stesso JSON formato con docName E docContent Base64)

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
}

Error Responses

Risposte di errore

IL API resi standard HTTP Codici di errore con dettagli dell'errore:

400 Bad Request

• Parametri di richiesta non validi
• Campi obbligatori mancanti
• Non valido Base64 codifica in docContent
• Tipo di codice a barre non valido
• Valori di allineamento non validi

401 Unauthorized

• Non valido o mancante API chiave
• API chiave non corretta Base64 codificato in Authorization intestazione
• Mancante Authorization: Base intestazione

500 Internal Server Error

• Errore di elaborazione lato server
• PDF errore di elaborazione
• Errore nella generazione del codice a barre

Formato della risposta di errore:

{
  "error": "Error message describing what went wrong"
}

Response Format Details

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 utilizzare Authorization: Basic YWJjMTIz

Carico utile

Esempio di base (solo campi obbligatori):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "text": "PDF4me Barcode Sample",
  "barcodeType": "qrCode",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "hideText": true
}

Esempio avanzato (con tutti i campi opzionali):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "text": "PDF4me Barcode Sample",
  "barcodeType": "qrCode",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "hideText": true,
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "113",
  "widthInPt": "113",
  "marginXInPt": "57",
  "marginYInPt": "57",
  "opacity": 100,
  "displayText": "below",
  "showOnlyInPrint": false,
  "isTextAbove": false,
  "async": true
}

Esempi di codice

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

C#

C# CSharp) Campione

Completo C# implementazione per l'aggiunta di codici a barre a PDF Documenti:

View C# Sample

Java

Java Campione

Java implementazione con gestione completa degli errori ed elaborazione delle risposte:

View Java Sample

JavaScript

JavaScript Campione

Node.js e compatibile con i browser JavaScript implementazione:

View JavaScript Sample

Python

Python Campione

Python implementazione con libreria requests e JSON gestione:

View Python Sample

Salesforce

Salesforce Campione

Salesforce Apex implementazione per CRM integrazione:

View Salesforce Sample

Google Script

Google Script Campione

Google Apps Script implementazione per Google Workspace integrazione:

View Google Script Sample

n8n

n8n Campione

n8n Implementazione del flusso di lavoro per l'automazione:

View n8n Sample

AWS Lambda

AWS Lambda Campione

Senza server AWS Lambda implementazione della funzione:

View AWS Lambda Sample

Casi d'uso e applicazioni industriali

E-commerce & Retail

Casi d'uso nell'e-commerce e nella vendita al dettaglio

• Cataloghi di prodottiGenera codici a barre per la gestione dell'inventario e l'identificazione dei prodotti.
• Etichette dei prezzi: Crea prezzi dinamici con integrazione del codice a barre per il checkout automatizzato
• Tracciamento dell'ordineAggiungi i codici di tracciamento ai documenti di spedizione per il monitoraggio in tempo reale dei pacchi.
• Sistemi di inventarioGenerazione massiva di codici a barre per la gestione del magazzino e il controllo delle scorte.

Logistics & Shipping

Casi d'uso per la logistica e le spedizioni

• Etichette di spedizioneAggiungere codici a barre di tracciamento ai documenti di consegna per la tracciabilità del pacco.
• Tracciamento del paccoGenerare identificativi univoci per ogni spedizione lungo tutta la catena di approvvigionamento.
• Gestione magazzino: Creare codici a barre per l'ubicazione degli scaffali e l'identificazione dei prodotti
• Catena di fornituraTraccia i prodotti lungo l'intera rete di distribuzione grazie ai codici incorporati

Healthcare & Medical

Casi d'uso in ambito sanitario e medico

• Cartelle cliniche dei pazientiAggiungere codici a barre per una rapida identificazione del paziente e accesso alla sua cartella clinica.
• Somministrazione di farmaciGenera codici a barre per il tracciamento dei farmaci e la verifica del dosaggio.
• Apparecchiature medicheEtichettare le apparecchiature con codici a barre di manutenzione per la gestione degli asset.
• Risultati di laboratorioAggiungere codici a barre ai documenti dei risultati dei test per un collegamento sicuro dei dati dei pazienti.

Government & Compliance

Casi d'uso per la pubblica amministrazione e la conformità normativa.

• Documenti di identitàAggiungere codici a barre di sicurezza alle patenti di guida e ai passaporti per la verifica.
• Documenti fiscaliGenerazione di codici di tracciamento per i moduli fiscali e monitoraggio della conformità
• Moduli di conformitàAggiungere codici a barre per il tracciamento normativo e le tracce di audit
• Registri pubblici: Creare identificatori di documenti ricercabili per i database governativi

Education & Libraries

Casi d'uso in ambito educativo e bibliotecario

• Tessere studentescheGenerare codici a barre per l'identificazione degli studenti e il controllo degli accessi al campus.
• Sistemi bibliotecariAggiungere codici a barre a libri e risorse per i sistemi di prestito automatizzati
• Documenti d'esame: Creare identificativi univoci per i documenti di prova e l'integrità accademica
• Servizi del campus: Monitorare l'utilizzo di attrezzature e risorse nelle strutture educative

Business & Finance

Casi d'uso in ambito aziendale e finanziario

• Elaborazione delle fattureAggiungi codici a barre per la gestione automatizzata delle fatture e l'elaborazione dei pagamenti.
• Gestione dei documenti: Creare identificativi univoci per documenti e registri aziendali
• Tracciamento delle risorseGenerare codici a barre per apparecchiature e risorse in tutta l'organizzazione
• Tracce di controlloAggiungere codici di tracciamento per la documentazione di conformità e i registri finanziari

Richiedi assistenza

Get Your API KeyAPI SamplesGetting Started