Lire le code-barres à partir de PDF - Scanner et extracteur API
PDF4me Lire le code-barres à partir de PDF permet d'extraire et de reconnaître différents types de codes-barres et QR codes depuis PDF documents utilisant des techniques avancées OCR et la technologie de reconnaissance des codes-barres. API processus de service PDF Il importe les fichiers et extrait les données des codes-barres avec leurs coordonnées de position, les informations de type et le texte extrait. API reçoit PDF contenu via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Prise en charge des codes-barres 1D et 2D, notamment QR codes, DataMatrix, PDF417, Code128, et aux formats sectoriels spécialisés, cette solution est idéale pour le traitement de documents, la gestion des stocks, les systèmes de suivi et l'automatisation des flux de travail.
Authentification de votre API Demande
Pour accéder au PDF4me REST APIChaque requête doit inclure des informations d'authentification valides. L'authentification garantit la sécurité des communications et confirme votre identité en tant qu'utilisateur autorisé. REST API.
Caractéristiques principales
- Reconnaissance complète des codes-barres: Prise en charge des codes-barres 1D et 2D, y compris QR codes, DataMatrix, PDF417, Code128, les codes postaux et les formats industriels spécialisés
- Sans couture PDF Intégration: Traitement direct de PDF documents avec support pour tous PDF versions et structures de documents complexes
- Traitement flexible des pages: Traiter des pages spécifiques, des plages de pages ou des documents entiers grâce à des fonctionnalités d'extraction sélective de codes-barres
- Traitement par lots d'entrepriseExtraire plusieurs codes-barres d'une ou plusieurs pages grâce à des flux de traitement automatisés.
- Sortie de données structurées: Renvoyer les données du code-barres dans un format structuré JSON Format avec coordonnées de position, informations de type et métadonnées pour une intégration système aisée
Types de codes-barres pris en charge
Le API prend en charge une gamme complète de formats de codes-barres pour une reconnaissance fiable :
Codes-barres 1D
- Code128 - Format de code-barres universel
- Code39 - Code-barres alphanumérique
- Code93 - Code-barres haute densité
- Codabar - Code-barres numérique
- EAN8/EAN13 - Numéro d'article européen
- UPC-A/UPC-E - Code produit universel
- Inter2of5 - Industriel 2 sur 5
- PatchCode - Codes de traitement de documents
Codes-barres 2D
- QR Code - Codes de réponse rapide
- DataMatrix - Code-barres 2D haute densité
- PDF417 - Fichier de données portable
- MicroQRCode - Compact QR variante
Formats spécialisés
- Codes postaux: Postnet, Planet, RM4SCC, Australia Post
- Courrier intelligent: USPS Codes-barres Intelligent Mail
- PharmaCode: Codes-barres pharmaceutiques
- RSS Codes: Symbologie spatiale réduite
Point de terminaison de l'API REST
Le PDF4me REST API utilise la norme HTTP méthodes d'interaction avec les ressources. Toutes les opérations de lecture de codes-barres sont effectuées via un point de terminaison unique :
- Méthode: POST
- Point final :
/api/v2/ReadBarcodes
Paramètres de l'API REST
Liste complète des paramètres pour la lecture du code-barres à partir de PDF REST APILes paramètres sont organisés par catégorie pour une meilleure compréhension et une mise en œuvre plus aisée.
Important: Les paramètres marqués d'un astérisque (*) sont obligatoires et doivent être fournis pour le API pour fonctionner correctement.
Paramètres requis
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| docContent* | Base64 | PDF contenu du fichier encodé en Base64 | JVBERi... |
| docName* | String | PDF Nom de fichier avec l'extension .pdf | document.pdf |
| barcodeType* | Array | Tableau des types de codes-barres à détecter. Utiliser ["all"] pour tous les types, ou des types spécifiques comme ["qrCode"], ["dataMatrix", "code128"] | ["all"] |
| pages* | String | Options de page : « tout », « 1 », « 1,3,5 », « 2-5 », « 1,3,7-10 », « 2- » | all |
| IsAsync* | Boolean | Activer le traitement asynchrone. Lorsque true, le API renvoie un statut 202 et fournit un système d'interrogation URL dans le Location en-tête | true |
Options de type de code-barres
| Taper | Description | Catégorie |
|---|---|---|
all | Détecter tous les types de codes-barres pris en charge | Universel |
unknown | Détecter les types de codes-barres inconnus | Universel |
qrCode | QR Code reconnaissance | 2D |
dataMatrix | DataMatrix reconnaissance | 2D |
pdf417 | PDF417 reconnaissance | 2D |
code128 | Code128 reconnaissance | 1D |
code39 | Code39 reconnaissance | 1D |
ean13 | EAN13 reconnaissance | 1D |
upca | UPC-A reconnaissance | 1D |
all_1D | Tous les types de codes-barres 1D | 1D |
all_2D | Tous les types de codes-barres 2D | 2D |
Sortir
Le PDF4me Lire le code-barres à partir de PDF REST API renvoie des réponses différentes selon le mode de traitement. API rendements structurés JSON données contenant des informations de code-barres.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Traitement synchrone (par défaut)
Quand IsAsync n'est pas défini ou est défini sur false, le API traite la demande immédiatement :
Code d'état : 200 OK
Content-Type: application/json
Corps de la réponse :
{
"barcodes": [
{
"type": "qrCode",
"text": "Barcode content",
"page": 1,
"x": 100,
"y": 200,
"width": 50,
"height": 50
}
]
}
Champs de réponse :
- codes-barres (tableau) : Tableau d'objets de code-barres détectés
- taper (chaîne de caractères) : Type de code-barres (par exemple, «qrCode", "dataMatrix", "code128")
- texte (chaîne de caractères) : Contenu/texte du code-barres extrait
- page (numéro) : Numéro de la page où le code-barres a été trouvé
- x (nombre) : Coordonnée X de la position du code-barres
- et (nombre) : Coordonnée Y de la position du code-barres
- largeur (nombre) : Largeur du code-barres
- hauteur (nombre) : Hauteur du code-barres
Exemple (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}`);
});
Traitement asynchrone
Quand IsAsync: true est réglé, le API traite la requête de manière asynchrone :
Code d'état : 202 Accepted
En-têtes de réponse :
Location: https://api.pdf4me.com/api/v2/ReadBarcodes/poll/12345-abcde-67890
Processus de sondage :
- Extraire le
LocationEn-tête de la réponse 202 - Sondage URL en utilisant GET demandes
- Continuez à sonder jusqu'à ce que vous receviez un 200 OK statut
- La réponse finale contient la même chose JSON format avec données de code-barres
Exemple de sondage :
// 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
}
Réponses d'erreur
Le API retours standard HTTP codes d'erreur avec détails de l'erreur :
- Paramètres de requête invalides
- Champs obligatoires manquants (
docContent,Nom du document,Type de code-barres,pages,IsAsync) - Invalide Base64 encodage dans
docContent - Format de tableau de type de code-barres invalide
- Spécification de page invalide
- Invalide ou manquant API clé
- API clé non correctement Base64 encodé dans Authorization en-tête
- Manquant
Authorization: Basiqueen-tête
- Erreur de traitement côté serveur
- PDF échec du traitement
- Échec de la reconnaissance du code-barres
Format de réponse en cas d'erreur :
{
"error": "Error message describing what went wrong"
}
Détails du format de réponse
Important: Le API toujours retourne JSON avec des données de code-barres structurées.
Structure de la réponse :
{
"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 En-tête :
- Succès:
application/json
Résultats vides : Si aucun code-barres n'est trouvé, la réponse contiendra un tableau vide :
{
"barcodes": []
}
Plusieurs codes-barres :
Le API peut détecter plusieurs codes-barres sur une même page ou sur des pages différentes. Tous les codes-barres détectés sont inclus dans le barcodes tableau.
Exemple de requête
En-tête
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Note:
- Obtenez votre API clé de la PDF4me Tableau de bord
- Le API La clé doit être Base64 encodé et préfixé par « Basic » dans le Authorization en-tête
- Exemple : Si votre API La clé est
abc123, encodez-le en Base64 et utiliserAuthorization: Basic YWJjMTIz
Charge utile
Exemple:
{
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"docName": "document.pdf",
"barcodeType": ["all"],
"pages": "all",
"IsAsync": true
}
Exemples de code
Le PDF4me Lire le code-barres à partir de PDF REST API propose des exemples de code dans plusieurs langages de programmation. Choisissez le langage qui convient le mieux à votre environnement de développement :
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Échantillon
Complet C# implémentation pour la lecture des codes-barres à partir de PDF documents :
Java Échantillon
Java implémentation avec gestion complète des erreurs et traitement des réponses :
JavaScript Échantillon
Node.js et compatible avec les navigateurs JavaScript mise en œuvre:
Python Échantillon
Python implémentation avec la bibliothèque requests et JSON manutention:
Google Script Échantillon
Google Apps Script mise en œuvre pour Google Workspace intégration :
Cas d'utilisation et applications industrielles
- Finance & Banking
- Business & Enterprise
- E-commerce & Retail
- Government & Compliance
- Technology & Development
Cas d'utilisation dans le secteur financier et bancaire
- Traitement des facturesExtraire les données des codes-barres des factures pour le traitement automatisé des paiements
- Documents financiers: Traiter les documents financiers comportant des codes-barres pour le traitement des paiements
- Traitement des paiementsExtraire les informations de paiement à partir des codes-barres des documents financiers
- Intégration bancaireIntégrer la lecture des codes-barres dans les applications et systèmes bancaires
Cas d'utilisation en entreprise
- Gestion des stocks: Lire les codes-barres des produits à partir de PDF documents pour le suivi des stocks
- Gestion de la chaîne d'approvisionnementSuivre les produits grâce à l'extraction des données des codes-barres. PDF documents
- Intégration des données: Intégrer les données des codes-barres provenant de PDFs dans les systèmes d'entreprise
- Automatisation des documentsAutomatiser l'extraction des données de codes-barres à partir de documents numérisés
- Automatisation des flux de travailAutomatiser l'extraction des données de codes-barres dans les systèmes de gestion de documents
- Automatisation des processus métierAutomatiser les flux de travail de traitement des codes-barres pour les opérations d'entreprise
Cas d'utilisation du commerce électronique et de la vente au détail
- Suivi des produits: Lire les codes-barres des produits à partir de PDF documents pour la gestion des stocks
- Traitement des commandesExtraire les données des codes-barres des documents de commande pour traitement
- Contrôle de qualité: Vérifier les informations produit à l'aide des données du code-barres PDF rapports
- Gestion de la chaîne d'approvisionnementSuivre les produits grâce à l'extraction des données des codes-barres. PDF documents
Cas d'utilisation gouvernementaux et de conformité
- Surveillance de la conformitéExtraire les codes de suivi des documents de conformité
- Documentation réglementaire: Traiter les documents réglementaires avec codes-barres
- Documents gouvernementauxExtraire les données des codes-barres des documents gouvernementaux
- Archives publiques: Traiter les documents publics contenant des informations de code-barres
Cas d'utilisation en matière de technologie et de développement
- API IntégrationIntégrer la lecture des codes-barres dans les flux de traitement de documents existants
- Traitement par lots: Traiter de grands volumes de PDF documents pour l'extraction de codes-barres
- Validation des données: Valider les données de code-barres extraites de PDF documents
- Traitement des formulairesExtraire les informations du code-barres de PDF formulaires et demandes
- Intégration de systèmesIntégrer la lecture des codes-barres dans les systèmes et les flux de travail de l'entreprise
Fonctionnalités de reconnaissance des codes-barres
Capacités de détection
- Prise en charge multiformat: Reconnaissance des codes-barres 1D et 2D dans différents formats
- Suivi de position: Données précises de localisation et de positionnement des codes-barres avec coordonnées
- Sélection de page: Traiter des pages spécifiques ou des documents entiers à l'aide des options de page
Fonctionnalités de traitement
- Reconnaissance par lotsExtraire plusieurs codes-barres d'une ou plusieurs pages
- Filtrage par type: Spécifiez les types de codes-barres à détecter à l'aide de
barcodeTypetableau - Sortie structurée: Renvoie les données du code-barres avec les informations de type, de texte, de page et de position