Crea codice a barre - QR Code generatore API

PDF4me Crea codice a barre consente di creare codici a barre autonomi e QR code immagini con supporto per oltre 150 tipi di codici a barre, tra cui QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417e formati specializzati. Questo API Il servizio genera immagini di codici a barre conformi ottimizzate per la stampa, la scansione mobile e le applicazioni digitali. API riceve dati di testo e parametri del codice a barre tramite REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Questa soluzione è ideale per sistemi di gestione dell'inventario, automazione dell'etichettatura dei prodotti e flussi di lavoro aziendali per la generazione di codici a barre.

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

• Libreria completa di codici a barre: Oltre 150 tipi di codici a barre inclusi QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417codici postali e simbologie di settore specializzate utilizzando il parametro Tipo di codice a barre
• Generazione di immagini autonoma: Crea immagini di codici a barre di alta qualità in modo indipendente, senza bisogno di documenti o modelli preesistenti, tramite la specifica del nome del file.
• Gestione avanzata del testoConfigura la visualizzazione, il posizionamento e la visibilità del testo del codice a barre con opzioni di formattazione professionali per una presentazione impeccabile utilizzando il parametro Testo.
• Integrazione aziendale: Semplice API con parametri minimi progettati per una perfetta integrazione nei sistemi e flussi di lavoro aziendali esistenti con una corretta mappatura dei parametri.

REST API Punto finale

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

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

Tipi di codice a barre supportati

Supporta oltre 150 tipi di codici a barre per una generazione completa di codici a barre basata su JSON acquisizione.

Codici a barre 1D popolari

• Code128 - Codice a barre universale (massimo 255 caratteri) utilizzando il parametro Tipo di codice a barre
• Code39 - Codice a barre alfanumerico (max 43 caratteri) tramite parametro di testo
• EAN13/EAN8 - Codici prodotto al dettaglio (13/8 caratteri) con specifica del nome del file
• UPC-A/UPC-E - Vendita al dettaglio nordamericana (12/8 caratteri) utilizzando API integrazione

Codici a barre 2D più diffusi

• QR Code - Scansione da dispositivo mobile (max 4.296 caratteri) utilizzando il parametro Tipo di codice a barre
• DataMatrix - 2D ad alta densità (massimo 2.335 caratteri) tramite parametro Testo
• PDF417 - Ampia capacità dati (massimo 2.710 caratteri) con specifica del nome del file
• Aztec - Eccellente correzione degli errori (massimo 3.832 caratteri) utilizzando API integrazione

Formati specializzati

• Codici postali: USPS, Royal Mail, Australia Post, Deutsche Post utilizzando il parametro Tipo di codice a barre
• Assistenza sanitaria: HIBC, GS1 DataBar, Pharmacode tramite il parametro Testo
• Logistica: MaxiCode, SSCC-18, ITF-14, GS1-128 con specifica del nome del file
• Varianti QR: Micro QR, iQR, rMQR utilizzando API integrazione

REST API Parametri

Elenco completo dei parametri per la creazione del codice a barre 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
testo*	String	Testo da codificare nel codice a barre. La lunghezza del testo dipende dal tipo di codice a barre.	PDF4me Create Barcode Sample
barcodeType*	String	Tipo di formato del codice a barre. Opzioni: qrCode, code128, dataMatrix, aztec, hanXin, pdf417, code39, ean13, ean8, upcA, upcE	qrCode
hideText*	Boolean	Nascondi l'etichetta del testo del codice a barre (true=nascondi, false=mostra il testo accanto al codice a barre)	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 Crea codice a barre REST API restituisce risposte diverse a seconda della modalità di elaborazione. API restituisce il codice a barre come file immagine binario (PNG formato), non come JSON.

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: image/png (o formato immagine appropriato)

Corpo della risposta: Il corpo della risposta contiene l'immagine del codice a barre come dati binari (PNG formato predefinito).

Come si usa:

1. Leggere il corpo della risposta come dati binari.
2. Salva i dati binari come file immagine (ad esempio, .png, .jpg)
3. Utilizzare il file immagine secondo necessità.

Esempio (JavaScript):

const response = await fetch(url, options);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
// Use the URL to display or download the image

Esempio (Python):

response = requests.post(url, json=payload, headers=headers)
if response.status_code == 200:
    with open('barcode.png', 'wb') as f:
        f.write(response.content)

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/CreateBarcode/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 l'immagine del codice a barre come dati binari (PNG formato)

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 blob = await pollResponse.blob();
    // Process blob (barcode image)
    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 (testo, tipo di codice a barre, nascondiTesto, asincrono)
• Tipo di codice a barre non valido
• La lunghezza del testo supera la capacità del tipo di codice a barre

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
• 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 restituisce dati di immagine binaria (PNG formato predefinito), non JSON.

Struttura della risposta:

• Content-Type: image/png (o tipo MIME dell'immagine appropriato)
• Corpo di rispostaDati di immagine binaria

Formato immagine:

• Formato predefinito: PNG
• L'immagine del codice a barre è pronta per l'uso diretto, il download o l'integrazione.

Salvare l'immagine:

JavaScript/Node.js:

const response = await fetch(url, options);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'barcode.png';
a.click();

Python:

response = requests.post(url, json=payload, headers=headers)
if response.status_code == 200:
    with open('barcode.png', 'wb') as f:
        f.write(response.content)

C#:

var response = await httpClient.PostAsync(url, content);
if (response.IsSuccessStatusCode)
{
    var imageBytes = await response.Content.ReadAsByteArrayAsync();
    await File.WriteAllBytesAsync("barcode.png", imageBytes);
}

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:

{
  "text": "PDF4me Create Barcode Sample",
  "barcodeType": "qrCode",
  "hideText": false,
  "async": true
}

Esempi di codice

IL PDF4me Crea codice a barre 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 la creazione di codici a barre:

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

n8n

n8n Campione

n8n Implementazione del flusso di lavoro per l'automazione:

View n8n Sample

Google Script

Google Script Campione

Google Apps Script implementazione per Google Workspace integrazione:

View Google Script 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

• Etichette dei prodottiGenera immagini di codici a barre indipendenti per imballaggi ed etichette di prodotti utilizzando il parametro Tipo di codice a barre.
• Etichette dei prezzi: Crea immagini di codici a barre per la determinazione dinamica dei prezzi e i sistemi di cassa automatizzati tramite parametro di testo
• Gestione dell'inventarioGenera immagini di codici a barre per la gestione del magazzino e il controllo delle scorte con specifica del nome del file.
• Cataloghi di prodotti: Crea immagini di codici a barre per l'identificazione dei prodotti e i sistemi di catalogazione utilizzando API integrazione

Logistics & Shipping

Casi d'uso per la logistica e le spedizioni

• Etichette di spedizione: Genera immagini di codici a barre indipendenti per il tracciamento e la consegna dei pacchi utilizzando il parametro Tipo di codice a barre
• Identificazione del pacco: Crea immagini di codici a barre univoche per ogni spedizione lungo le catene di approvvigionamento tramite parametro di testo
• Sistemi di magazzinoGenera immagini di codici a barre per l'ubicazione degli scaffali e il tracciamento dell'inventario con specifica del nome del file.
• Catena di fornitura: Crea immagini di codici a barre per il tracciamento dei prodotti attraverso le reti di distribuzione utilizzando API integrazione

Healthcare & Medical

Casi d'uso in ambito sanitario e medico

• Identificazione del pazienteGenera immagini di codici a barre per braccialetti e cartelle cliniche dei pazienti utilizzando il parametro Tipo di codice a barre.
• Monitoraggio dei farmaci: Creare immagini di codici a barre per l'identificazione dei farmaci e la verifica del dosaggio tramite parametro di testo
• Gestione delle apparecchiatureGenera immagini di codici a barre per il tracciamento di apparecchiature mediche e beni con specifica del nome del file.
• Tracciamento dei campioni di laboratorio: Creare immagini di codici a barre per campioni di prova e identificazione dei risultati utilizzando API integrazione

Government & Compliance

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

• Documenti di identitàGenera immagini di codici a barre per patenti di guida, passaporti e carte d'identità utilizzando il parametro Tipo di codice a barre.
• Generazione di moduli: Crea immagini di codici a barre per moduli fiscali e documentazione di conformità tramite parametro di testo
• Tracciamento dei documenti: Genera immagini di codici a barre per il tracciamento normativo e le tracce di controllo con specifica del nome del file
• Registri pubblici: Creare immagini di codici a barre per i sistemi di identificazione dei documenti governativi utilizzando API integrazione

Education & Libraries

Casi d'uso in ambito educativo e bibliotecario

• Tessere studentesche: Genera immagini di codici a barre per l'identificazione degli studenti e l'accesso al campus utilizzando il parametro Tipo di codice a barre
• Sistemi bibliotecari: Crea immagini di codici a barre per l'identificazione dei libri e i sistemi di prestito tramite parametro di testo
• Sicurezza degli esami: Genera immagini di codici a barre per testare l'identificazione e l'integrità dei documenti con specifica del nome del file
• Servizi del campus: Crea immagini di codici a barre per il monitoraggio di attrezzature e risorse utilizzando API integrazione

Business & Finance

Casi d'uso in ambito aziendale e finanziario

• Sistemi di fatturazioneGenera immagini di codici a barre per l'elaborazione e il pagamento automatizzati delle fatture utilizzando il parametro Tipo di codice a barre.
• Gestione dei documenti: Crea immagini di codici a barre per l'identificazione di documenti aziendali tramite parametro di testo
• Tracciamento delle risorseGenera immagini di codici a barre per sistemi di gestione di apparecchiature e risorse con specifica del nome del file.
• Documentazione di conformità: Crea immagini di codici a barre per tracce di controllo e registri finanziari utilizzando API integrazione

Richiedi assistenza

Get Your API KeyAPI SamplesGetting Started