Créer un code-barres - QR Code Générateur API

PDF4me Créer un code-barres vous permet de créer des codes-barres autonomes et QR code images prenant en charge plus de 150 types de codes-barres, y compris QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417et des formats spécialisés. API Ce service génère des images de codes-barres conformes, optimisées pour l'impression, la lecture mobile et les applications numériques. API reçoit des données textuelles et des paramètres de code-barres via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Cette solution est idéale pour les systèmes de gestion des stocks, l'automatisation de l'étiquetage des produits et les flux de travail de génération de codes-barres en entreprise.

Articles de blog connexes(1)

Vous avez du mal à ajouter des codes-barres à vos PDF\_? Voici la solution complète\_!

Guide pratique pour l'ajout automatisé de codes-barres et de codes QR aux documents PDF. Découvrez les différents types de codes-barres, les stratégies de positionnement et des exemples concrets d'utilisation.

Lire l'article →

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.

Get your api Key

Caractéristiques principales

Bibliothèque complète de codes-barres: Plus de 150 types de codes-barres, y compris QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417, les codes postaux et les symbologies industrielles spécialisées utilisant le paramètre Type de code-barres
Génération d'images autonomeCréez des images de codes-barres de haute qualité de manière indépendante, sans avoir besoin de documents ou de modèles existants, grâce à la spécification du nom de fichier.
Gestion avancée des textesConfigurez l'affichage, le positionnement et la visibilité du texte du code-barres grâce à des options de mise en forme professionnelles pour une présentation soignée, en utilisant le paramètre Texte.
Intégration d'entreprise: Simple API avec des paramètres minimaux conçus pour une intégration transparente aux systèmes et flux de travail existants grâce à un mappage de paramètres approprié

REST API Point de terminaison

Le PDF4me REST API utilise la norme HTTP méthodes d'interaction avec les ressources. Toutes les opérations de génération de codes-barres sont effectuées via un point de terminaison unique :

Méthode: POST
Point final : /api/v2/CreateBarcode

Types de codes-barres pris en charge

Prend en charge plus de 150 types de codes-barres pour une génération complète de codes-barres basée sur JSON spécification.

Codes-barres 1D populaires

Code128 - Code-barres universel (255 caractères max.) utilisant le paramètre Type de code-barres
Code39 - Code-barres alphanumérique (43 caractères max.) via le paramètre Texte
EAN13/EAN8 - Codes de produits de détail (13/8 caractères) avec spécification du nom de fichier
UPC-A/UPC-E - Vente au détail nord-américaine (12/8 caractères) utilisant API intégration

Codes-barres 2D populaires

QR Code - Numérisation mobile (4 296 caractères max.) à l'aide du paramètre Type de code-barres
DataMatrix - 2D haute densité (2 335 caractères max.) via le paramètre Texte
PDF417 - Grande capacité de données (2 710 caractères max.) avec spécification du nom de fichier
Aztec - Excellente correction d'erreurs (3 832 caractères max) grâce à API intégration

Formats spécialisés

Codes postaux: USPS, Royal Mail, Australia Post, Deutsche Post en utilisant le paramètre Type de code-barres
Soins de santé: HIBC, GS1 DataBar, Pharmacode via le paramètre Texte
Logistique: MaxiCode, SSCC-18, ITF-14, GS1-128 avec spécification du nom de fichier
Variantes QR: Micro QR, iQR, rMQR en utilisant API intégration

REST API Paramètres

Liste complète des paramètres pour la création de code-barres 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
texte*	String	Texte à encoder dans le code-barres. La longueur du texte dépend du type de code-barres.	`PDF4me Create Barcode Sample`
barcodeType*	String	Type de format de code-barres. Options : qrCode, code128, dataMatrix, aztec, hanXin, pdf417, code39, ean13, ean8, upcA, upcE	`qrCode`
hideText*	Boolean	Masquer l'étiquette du code-barres (true=masquer, false=afficher le texte à côté du code-barres)	`false`
async*	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`

Sortir

Le PDF4me Créer un code-barres REST API renvoie des réponses différentes selon le mode de traitement. API renvoie le code-barres sous forme de fichier image binaire (PNG format), pas comme JSON.

Success Response
Asynchronous Processing
Error Responses
Response Format Details

Traitement synchrone (par défaut)

Quand async 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: image/png (ou format d'image approprié)

Corps de la réponse : Le corps de la réponse contient l'image du code-barres sous forme de données binaires (PNG format par défaut).

Mode d'emploi :

Lire le corps de la réponse sous forme de données binaires
Enregistrez les données binaires sous forme de fichier image (par exemple, .png, .jpg).
Utilisez le fichier image selon vos besoins

Exemple (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

Exemple (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)

Traitement asynchrone

Quand async: 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/CreateBarcode/poll/12345-abcde-67890

Processus de sondage :

Extraire le Location En-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 l'image du code-barres sous forme de données binaires (PNG format)

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 blob = await pollResponse.blob();
    // Process blob (barcode image)
    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 :

400 Bad Request

Paramètres de requête invalides
Champs obligatoires manquants (texte, Type de code-barres, masquerTexte, asynchrone)
Type de code-barres invalide
La longueur du texte dépasse la capacité du type de code-barres

401 Unauthorized

Invalide ou manquant API clé
API clé non correctement Base64 encodé dans Authorization en-tête
Manquant Authorization: Basique en-tête

500 Internal Server Error

Erreur de traitement côté serveur
Échec de la génération 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 renvoie des données d'image binaires (PNG format par défaut), pas JSON.

Structure de la réponse :

Content-Type: image/png (ou type MIME d'image approprié)
Organe de réponse: Données d'image binaire

Format d'image :

Format par défaut : PNG
L'image du code-barres est prête à être utilisée, téléchargée ou intégrée directement.

Enregistrement de l'image :

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);
}

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

Charge utile

Exemple:

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

Exemples de code

Le PDF4me Créer un code-barres 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# (CSharp) Échantillon

Complet C# implémentation pour la création de codes-barres :

View C# Sample

Cas d'utilisation et applications industrielles

Cas d'utilisation du commerce électronique et du commerce de détail

Étiquettes de produitsGénérer des images de codes-barres autonomes pour les emballages et les étiquettes de produits à l'aide du paramètre Type de code-barres
Étiquettes de prix: Créer des images de codes-barres pour les systèmes de tarification dynamique et de paiement automatisé via le paramètre Texte
Gestion des stocksGénérer des images de codes-barres pour la gestion d'entrepôt et le contrôle des stocks avec spécification du nom de fichier
Catalogues de produits: Créer des images de codes-barres pour l'identification des produits et les systèmes de catalogues à l'aide de API intégration

Obtenez de l'aide

Get Your API Key API Samples Getting Started

Authentification de votre API Demande​

Caractéristiques principales​

REST API Point de terminaison​

Types de codes-barres pris en charge​

Codes-barres 1D populaires​

Codes-barres 2D populaires​

Formats spécialisés​

REST API Paramètres​

Paramètres requis​

Sortir​

Exemple de requête​

En-tête​

Charge utile​

Exemples de code​

Cas d'utilisation et applications industrielles​

Obtenez de l'aide​