Aller au contenu
Accueil moxon

Génération de codes-barres

L'endpoint /barcode génère des images de codes-barres à partir d'une chaîne de données. Il supporte plusieurs formats standards et retourne le résultat en SVG ou PNG.

gethttps://api.moxon.dev/v5/barcode

Détails des formats

  • Code 128 : Encode tout caractère ASCII imprimable (codes 32–126).
  • EAN-13 / EAN-8 / UPC-A : Numérique uniquement. Le chiffre de contrôle est calculé automatiquement s'il est absent, ou validé s'il est fourni.
  • Code 39 : Alphanumérique (A-Z, 0-9, espace, - . $ / + %). La saisie est automatiquement mise en majuscules ; les caractères de début/fin sont ajoutés automatiquement.
Essayerget/v5/barcode

Paramètres

  • datastringrequis

    Chaîne de données à encoder dans le code-barres

  • typestringoptionnel

    Par défaut : code128.

    Format du code-barres : code128, ean13, ean8, upca, code39

    • code128
    • ean13
    • ean8
    • upca
    • code39
  • format"svg" | "png"optionnel

    Par défaut : svg.

    Format de sortie : svg ou png

  • widthnumberoptionnel

    Par défaut : 2.

    Largeur unitaire des barres en pixels (1–5)

  • heightnumberoptionnel

    Par défaut : 100.

    Hauteur des barres en pixels (50–300)

  • colorstringoptionnel

    Par défaut : #000000.

    Couleur des barres en hexadécimal (ex. 000000)

  • bgstringoptionnel

    Par défaut : #ffffff.

    Couleur de fond en hexadécimal (ex. ffffff)

Réponse

Par défaut (format=svg), l'endpoint retourne une image SVG inline (Content-Type: image/svg+xml), utilisable dans une balise <img> :

<img src="https://api.moxon.dev/v5/barcode?data=Hello123" alt="Code-barres" />

Avec format=png, la réponse est un buffer PNG brut (Content-Type: image/png) :

<img src="https://api.moxon.dev/v5/barcode?data=Hello123&format=png" alt="Code-barres" />

Exemples de code

Gestion des erreurs

  • 400Please provide data to encode (?data={string})Le paramètre data est manquant
  • 400Type must be one of: code128, ean13, ean8, upca, code39La valeur de type n'est pas valide
  • 400Format must be one of: svg, pngLa valeur de format n'est pas valide
  • 400Width must be between 1 and 5Le paramètre width est hors de la plage autorisée
  • 400Height must be between 50 and 300Le paramètre height est hors de la plage autorisée
  • 400Please provide valid dimensions (&width={px}&height={px})Le paramètre width ou height n'est pas un nombre valide
  • 400Code 128 only supports ASCII 32-126 (invalid char: "{ch}")Un caractère dans data est hors de la plage Code 128 supportée
  • 400EAN-13 requires 12 or 13 digitsLa chaîne data n'a pas le bon nombre de chiffres
  • 400Invalid EAN-13 check digit (expected {expected}, got {actual})Le chiffre de contrôle EAN-13 fourni ne correspond pas à la valeur calculée
  • 400EAN-8 requires 7 or 8 digitsLa chaîne data n'a pas le bon nombre de chiffres
  • 400Invalid EAN-8 check digit (expected {expected}, got {actual})Le chiffre de contrôle EAN-8 fourni ne correspond pas à la valeur calculée
  • 400UPC-A requires 11 or 12 digitsLa chaîne data n'a pas le bon nombre de chiffres
  • 400Code 39 invalid character: "{ch}". Allowed: A-Z, 0-9, space, - . $ / + %Un caractère dans data n'est pas autorisé en Code 39
  • 400Invalid color (use hex like ff6600)Une valeur color ou bg n'est pas une couleur hexadécimale valide