Leggi il codice a barre da PDF - Scanner ed estrattore API
PDF4me Leggi il codice a barre da PDF consente di estrarre e riconoscere vari tipi di codici a barre e QR codes da PDF documenti utilizzando la tecnologia avanzata OCR e tecnologia di riconoscimento dei codici a barre. Questo API processi di servizio PDF file ed estrae i dati del codice a barre con coordinate di posizione, informazioni sul tipo e testo estratto. Il API riceve PDF contenuto attraverso REST API chiamate, utilizzando Base64 codifica per trasmissione sicura. Con supporto per codici a barre 1D e 2D inclusi QR codes, DataMatrix, PDF417, Code128Grazie alla compatibilità con formati specifici di settore, questa soluzione è ideale per l'elaborazione di documenti, la gestione dell'inventario, i sistemi di tracciamento e l'automazione dei flussi di lavoro.
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.
Caratteristiche principali
- Riconoscimento completo dei codici a barre: Supporto per codici a barre 1D e 2D inclusi QR codes, DataMatrix, PDF417, Code128codici postali e formati specializzati del settore
- senza veli PDF Integrazione: Elaborazione diretta di PDF documenti con supporto per tutti PDF versioni e strutture documentali complesse
- Elaborazione flessibile delle pagineElabora pagine specifiche, intervalli di pagine o interi documenti con funzionalità di estrazione selettiva dei codici a barre.
- Elaborazione batch aziendaleEstrai più codici a barre da una o più pagine con flussi di lavoro di elaborazione automatizzati
- Output di dati strutturati: Restituisce i dati del codice a barre in formato strutturato JSON formato con coordinate di posizione, informazioni sul tipo e metadati per una facile integrazione del sistema
Tipi di codice a barre supportati
IL API Supporta una gamma completa di formati di codici a barre per un riconoscimento affidabile:
Codici a barre 1D
- Code128 - Formato universale del codice a barre
- Code39 - Codice a barre alfanumerico
- Code93 - Codice a barre ad alta densità
- Codabar - Codice a barre numerico
- EAN8/EAN13 - Numero dell'articolo europeo
- UPC-A/UPC-E - Codice prodotto universale
- Inter2of5 - Industriale 2 di 5
- PatchCode - Codici di elaborazione dei documenti
Codici a barre 2D
- QR Code - Codici di risposta rapida
- DataMatrix - Codice a barre 2D ad alta densità
- PDF417 - File di dati portatile
- MicroQRCode - Compatto QR variante
Formati specializzati
- Codici postali: Postnet, Planet, RM4SCC, Australia Post
- Posta intelligente: USPS Codici a barre Intelligent Mail
- PharmaCode: Codici a barre farmaceutici
- RSS CodesSimbologia dello spazio ridotto
Endpoint API REST
IL PDF4me REST API utilizza standard HTTP metodi per interagire con le risorse. Tutte le operazioni di lettura dei codici a barre vengono eseguite tramite un unico endpoint:
- Metodo: POST
- Punto finale:
/api/v2/ReadBarcodes
Parametri dell'API REST
Elenco completo dei parametri per la lettura del codice a barre da 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 |
|---|---|---|---|
| docContent* | Base64 | PDF contenuto del file codificato in Base64 | JVBERi... |
| docName* | String | PDF nome del file con estensione .pdf | document.pdf |
| barcodeType* | Array | Serie di tipi di codice a barre da rilevare. Utilizzare ["all"] per tutti i tipi o tipi specifici come ["qrCode"], ["dataMatrix", "code128"] | ["all"] |
| pagine* | String | Opzioni pagina: "tutte", "1", "1,3,5", "2-5", "1,3,7-10", "2-" | all |
| IsAsync* | Boolean | Abilita l'elaborazione asincrona. Quando true, IL API restituisce uno stato 202 e fornisce un polling URL nel Location intestazione | true |
Opzioni relative al tipo di codice a barre
| Tipo | Descrizione | Categoria |
|---|---|---|
all | Rileva tutti i tipi di codice a barre supportati | Universale |
unknown | Rileva tipi di codici a barre sconosciuti | Universale |
qrCode | QR Code riconoscimento | 2D |
dataMatrix | DataMatrix riconoscimento | 2D |
pdf417 | PDF417 riconoscimento | 2D |
code128 | Code128 riconoscimento | 1D |
code39 | Code39 riconoscimento | 1D |
ean13 | EAN13 riconoscimento | 1D |
upca | UPC-A riconoscimento | 1D |
all_1D | Tutti i tipi di codici a barre 1D | 1D |
all_2D | Tutti i tipi di codici a barre 2D | 2D |
Produzione
IL PDF4me Leggi il codice a barre da PDF REST API restituisce risposte diverse a seconda della modalità di elaborazione. API rendimenti strutturati JSON dati con informazioni di codice a barre.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Elaborazione sincrona (impostazione predefinita)
Quando IsAsync non è impostato o impostato su false, IL API elabora la richiesta immediatamente:
Codice di stato: 200 OK
Content-Type: application/json
Corpo della risposta:
{
"barcodes": [
{
"type": "qrCode",
"text": "Barcode content",
"page": 1,
"x": 100,
"y": 200,
"width": 50,
"height": 50
}
]
}
Campi di risposta:
- codici a barre (array): Array di oggetti codice a barre rilevati
- tipo (stringa): Tipo di codice a barre (ad esempio, "qrCode", "dataMatrix", "code128")
- testo (stringa): Contenuto/testo del codice a barre estratto
- pagina (numero): Numero di pagina in cui è stato trovato il codice a barre
- X (numero): coordinata X della posizione del codice a barre
- E (numero): coordinata Y della posizione del codice a barre
- larghezza (numero): Larghezza del codice a barre
- altezza (numero): Altezza del codice a barre
Esempio (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
data.barcodes.forEach(barcode => {
console.log(`Found ${barcode.type}: ${barcode.text} on page ${barcode.page}`);
});
Elaborazione asincrona
Quando IsAsync: 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/ReadBarcodes/poll/12345-abcde-67890
Procedura di votazione:
- Estrarre il
Locationintestazione dalla risposta 202 - Sondare il URL utilizzando GET richieste
- Continua a fare sondaggi finché non ricevi un 200 OK stati
- La risposta finale contiene lo stesso JSON formato con dati del codice a barre
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.barcodes array
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
Risposte di errore
IL API resi standard HTTP Codici di errore con dettagli dell'errore:
- Parametri di richiesta non validi
- Campi obbligatori mancanti (
docContent,docName,tipo di codice a barre,pagine,IsAsync) - Non valido Base64 codifica in
docContent - Formato array del tipo di codice a barre non valido
- Specifiche di pagina non valide
- Non valido o mancante API chiave
- API chiave non corretta Base64 codificato in Authorization intestazione
- Mancante
Authorization: Baseintestazione
- Errore di elaborazione lato server
- PDF errore di elaborazione
- Errore nel riconoscimento del codice a barre
Formato della risposta di errore:
{
"error": "Error message describing what went wrong"
}
Dettagli sul formato di risposta
Importante: IL API ritorna sempre JSON con dati di codici a barre strutturati.
Struttura della risposta:
{
"barcodes": [
{
"type": "string", // Barcode type
"text": "string", // Extracted barcode content
"page": number, // Page number (1-based)
"x": number, // X coordinate
"y": number, // Y coordinate
"width": number, // Barcode width
"height": number // Barcode height
}
]
}
Content-Type Intestazione:
- Successo:
application/json
Risultati vuoti: Se non vengono trovati codici a barre, la risposta conterrà un array vuoto:
{
"barcodes": []
}
Codici a barre multipli:
IL API può rilevare più codici a barre sulla stessa pagina o su pagine diverse. Tutti i codici a barre rilevati sono inclusi nel barcodes vettore.
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 utilizzareAuthorization: Basic YWJjMTIz
Carico utile
Esempio:
{
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"docName": "document.pdf",
"barcodeType": ["all"],
"pages": "all",
"IsAsync": true
}
Esempi di codice
IL PDF4me Leggi il codice a barre da PDF REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# CSharp) Campione
Completo C# implementazione per la lettura di codici a barre da PDF Documenti:
Java Campione
Java implementazione con gestione completa degli errori ed elaborazione delle risposte:
JavaScript Campione
Node.js e compatibile con i browser JavaScript implementazione:
Google Script Campione
Google Apps Script implementazione per Google Workspace integrazione:
Casi d'uso e applicazioni industriali
- Finance & Banking
- Business & Enterprise
- E-commerce & Retail
- Government & Compliance
- Technology & Development
Casi d'uso in ambito finanziario e bancario
- Elaborazione delle fattureEstrarre i dati del codice a barre dalle fatture per l'elaborazione automatizzata dei pagamenti.
- Documenti finanziari: Elaborazione di documenti finanziari con codici a barre per l'elaborazione dei pagamenti
- Elaborazione dei pagamentiEstrarre le informazioni di pagamento dai codici a barre nei documenti finanziari
- Integrazione bancariaIntegrare la lettura dei codici a barre nelle applicazioni e nei sistemi bancari
Casi d'uso aziendali e per le imprese
- Gestione dell'inventario: Leggi i codici a barre dei prodotti da PDF documenti per il monitoraggio delle scorte
- Gestione della catena di approvvigionamento: Traccia i prodotti tramite l'estrazione dei dati del codice a barre da PDF Documenti
- Integrazione dei dati: Integra i dati del codice a barre da PDFs nei sistemi aziendali
- Automazione dei datiAutomatizzare l'estrazione dei dati dei codici a barre dai documenti scansionati
- Automazione del flusso di lavoroAutomatizzare l'estrazione dei dati dei codici a barre nei sistemi di gestione documentale.
- Automazione dei processi aziendaliAutomatizzare i flussi di lavoro di elaborazione dei codici a barre per le operazioni aziendali.
Casi d'uso nell'e-commerce e nella vendita al dettaglio
- Tracciamento del prodotto: Leggi i codici a barre dei prodotti da PDF documenti per la gestione dell'inventario
- Elaborazione degli ordiniEstrarre i dati del codice a barre dai documenti d'ordine per l'elaborazione.
- Controllo qualità: Verifica le informazioni del prodotto utilizzando i dati del codice a barre da PDF rapporti
- Gestione della catena di approvvigionamento: Traccia i prodotti tramite l'estrazione dei dati del codice a barre da PDF Documenti
Casi d'uso per la pubblica amministrazione e la conformità normativa.
- Monitoraggio della conformitàEstrarre i codici di tracciamento dai documenti di conformità
- Documentazione normativa: Elaborazione dei documenti normativi con codici a barre
- Documenti governativiEstrazione dei dati dei codici a barre dai documenti governativi
- Registri pubblici: Elaborare i documenti pubblici contenenti informazioni tramite codice a barre
Casi d'uso in ambito tecnologico e di sviluppo
- API IntegrazioneIntegrare la lettura dei codici a barre nei flussi di lavoro di elaborazione dei documenti esistenti
- Elaborazione in batch: Elaborare grandi volumi di PDF documenti per l'estrazione del codice a barre
- Validazione dei dati: Convalida i dati del codice a barre estratti da PDF Documenti
- Generazione di moduli: Estrai le informazioni del codice a barre da PDF moduli e domanda
- Integrazione di sistemaIntegrare la lettura dei codici a barre nei sistemi e nei flussi di lavoro aziendali.
Funzionalità di riconoscimento del codice a barre
Capacità di rilevamento
- Supporto multiformatoRiconoscimento di codici a barre 1D e 2D in vari formati
- Tracciamento della posizioneDati precisi di localizzazione e posizionamento del codice a barre con coordinate
- Selezione della pagina: Elabora pagine specifiche o interi documenti utilizzando le opzioni di pagina
Caratteristiche di elaborazione
- Riconoscimento del lotto: Estrarre più codici a barre da una o più pagine
- Tipo di filtro: Specifica quali tipi di codice a barre rilevare utilizzando il
barcodeTypevettore - Output strutturatoRestituisce i dati del codice a barre con informazioni su tipo, testo, pagina e posizione.