Ajouter un code-barres à PDF - QR Code Intégration API

PDF4me Ajouter un code-barres à PDF vous permet d'ajouter des codes-barres professionnels et QR codes à PDF des documents avec des commandes précises de positionnement, de dimensionnement et de mise en forme. API processus de service PDF fichiers et ajoute des codes-barres à l'aide de Base64 Encodage pour une transmission sécurisée. Prend en charge plus de 150 types de codes-barres, notamment QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417et dans des formats spécialisés, cette solution est idéale pour les systèmes de gestion des stocks, l'automatisation des étiquettes d'expédition, les flux de travail de suivi des documents et l'intégration des codes-barres d'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

Prise en charge complète des codes-barres: Plus de 150 types de codes-barres, y compris QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417, les codes postaux et les formats industriels spécialisés
Contrôle de positionnement précis: Placez les codes-barres n'importe où sur PDF des pages d'une précision au pixel près grâce à des systèmes de mesure millimétriques et ponctuels
Options de dimensionnement avancéesDimensions flexibles des codes-barres avec dimensionnement automatique et contrôle personnalisé de la largeur et de la hauteur pour des performances de lecture optimales.
Gestion de texte professionnelleConfigurez l'affichage, le positionnement (au-dessus/en dessous) et la visibilité du texte du code-barres grâce à des options de mise en forme personnalisables.
Opacité et transparenceAjustez les niveaux de transparence des codes-barres pour les effets de filigrane, les superpositions de documents et une présentation professionnelle.
Traitement par lots d'entrepriseAjoutez des codes-barres à plusieurs pages, documents ou collections de documents entières grâce à des flux de traitement automatisés.

REST API Point de terminaison

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

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

Types de codes-barres pris en charge

Prend en charge plus de 150 types de codes-barres pour une couverture complète PDF intégration.

Codes-barres 1D populaires

Code128 - Code-barres universel (255 caractères max.)
Code39 - Code-barres alphanumérique (43 caractères max.)
EAN13/EAN8 - Codes produits de détail (13/8 caractères)
UPC-A/UPC-E - Vente au détail en Amérique du Nord (12/8 caractères)

Codes-barres 2D populaires

QR Code - Numérisation mobile (4 296 caractères max)
DataMatrix - 2D haute densité (2 335 caractères max)
PDF417 - Grande capacité de données (2 710 caractères max.)
Aztec - Excellente correction d'erreurs (3 832 caractères max.)

Formats spécialisés

Codes postaux: USPS, Royal Mail, Australia Post, Deutsche Post
Soins de santé: HIBC, GS1 DataBar, Pharmacode
Logistique: MaxiCode, SSCC-18, ITF-14, GS1-128
Variantes QR: Micro QR, iQR, rMQR

REST API Paramètres

Liste complète des paramètres pour l'ajout de code-barres 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
docName*	String	Sortir PDF Nom de fichier avec l'extension .pdf	`output.pdf`
docContent*	Base64	Le contenu de l'entrée PDF fichier encodé en Base64	`JVBERi...`
texte*	String	Texte à encoder dans le code-barres. La longueur du texte dépend du type de code-barres.	`PDF4me Barcode Sample`
barcodeType*	String	Type de format de code-barres. Options : qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcE	`qrCode`
pages*	String	Pages cibles (par exemple, « 1-3 », « toutes », « 1 », « 1,3,5 », « 2-5 », « 1,3,7-10 », « 2- »)	`1-3`
alignX*	String	Alignement horizontal : Gauche, Centre, ou Droite	`Right`
alignY*	String	Alignement vertical : Haut, Milieu, ou Bas	`Bottom`
hideText*	Boolean	Masquer l'étiquette du code-barres (true=masquer, false=afficher le texte à côté du code-barres)	`true`

Paramètres optionnels

Paramètre	Taper	Description	Exemple
heightInMM	String	Hauteur du code-barres en millimètres (0 = automatique)	`40`
widthInMM	String	Largeur du code-barres en millimètres (0 = automatique)	`40`
marginXInMM	String	Marge horizontale en millimètres	`20`
marginYInMM	String	Marge verticale en millimètres	`20`
heightInPt	String	Hauteur du code-barres en points	`113`
widthInPt	String	Largeur du code-barres en points	`113`
marginXInPt	String	Marge horizontale en points	`57`
marginYInPt	String	Marge verticale en points	`57`
opacity	Integer	Niveau de transparence (0-100) : 0 = invisible, 100 = totalement opaque	`100`
displayText	String	Position du texte : au-dessus de ou ci-dessous	`below`
showOnlyInPrint	Boolean	Afficher uniquement en impression (vrai) ou en visualisation et impression (faux)	`false`
isTextAbove	Boolean	Texte au-dessus du code-barres (vrai) ou en dessous (faux)	`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 Ajouter un code-barres à PDF REST API renvoie des réponses différentes selon le mode de traitement. API renvoie le PDF comme un Base64chaîne encodée dans JSON format, et non sous forme de données binaires.

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: application/json

Corps de la réponse :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Champs de réponse :

docName (chaîne de caractères) : La sortie PDF nom de fichier
docContent (chaîne de caractères) : Le PDF fichier avec code-barres ajouté, encodé comme Base64 chaîne

Mode d'emploi :

Extraire le docContent champ du JSON réponse
Décodez le Base64 chaîne permettant d'obtenir le binaire PDF données
Enregistrer ou traiter le PDF classer selon les besoins

Exemple (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

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/addbarcode/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 la même chose JSON format avec docName et docContent (Base64)

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.docContent (Base64 PDF)
    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
Invalide Base64 encodage dans docContent
Type de code-barres invalide
Valeurs d'alignement invalides

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
PDF échec du traitement
É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 toujours retourne JSON, jamais binaire PDF données directement.

Structure de la réponse :

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type En-tête :

Succès: application/json
Le PDF est intégré en tant que Base64 chaîne à l'intérieur de la JSON réponse

Pourquoi Base64?

JSON-codage sûr pour les données binaires
Facile à transmettre sur HTTP
Compatible avec tous les langages de programmation
Peut être directement intégré dans JSON sans échapper aux problèmes

Décodage Base64 à 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);

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 simple (champs obligatoires uniquement) :

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

Exemple avancé (avec tous les champs facultatifs) :

{
  "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
}

Exemples de code

Le PDF4me Ajouter un code-barres à 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# (CSharp) Échantillon

Complet C# implémentation pour l'ajout de codes-barres à PDF documents :

View C# Sample

Cas d'utilisation et applications industrielles

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

Catalogues de produitsGénérer des codes-barres pour la gestion des stocks et l'identification des produits
Étiquettes de prixCréez une tarification dynamique avec intégration de codes-barres pour un encaissement automatisé.
Suivi de commandeAjoutez des codes de suivi aux documents d'expédition pour un suivi des colis en temps réel.
Systèmes d'inventaireGénération en masse de codes-barres pour la gestion d'entrepôt et le contrôle des stocks

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​

Paramètres optionnels​

Sortir​

Exemple de requête​

En-tête​

Charge utile​

Exemples de code​

Cas d'utilisation et applications industrielles​

Obtenez de l'aide​