Codes-barres

Créez des codes-barres sur 34 symbologies, avec couleur, taille et libellé.

Types pris en charge

Passez type parmi ces clés de symbologie. value doit respecter les règles de ce type.

C32
C39
C39+
C39E
C39E+
C93
S25
S25+
I25
I25+
ITF14
C128
C128A
C128B
C128C
EAN2
EAN5
EAN8
EAN13
UPCA
UPCE
MSI
MSI+
POSTNET
PLANET
TELEPENALPHA
TELEPENNUMERIC
RMS4CC
KIX
IMB
CODABAR
CODE11
PHARMA
PHARMA2T

POST/api/v1/barcodes

Créer code-barres

Envoyez du JSON avec name, type et value. type est une clé de symbologie comme C128 ou EAN13. Les couleurs, width_scale, height et display_text contrôlent l'image générée.

Nom	Type	Requis	Par défaut	Description
name	string	Oui	—	Libellé enregistré sur la ressource.
type	string	Oui	C128	Clé de symbologie telle que C128, EAN13 ou UPCA.
value	string	Oui	—	Données encodées dans le code-barres. Doivent être valides pour le type choisi.
project_id	integer	Non	—	Projet auquel rattacher la ressource.
is_bulk	boolean	Non	false	Si true, un code-barres est créé par ligne dans value.
foreground_color	string	Non	#000000	Couleur des modules en HEX.
background_color	string	Non	#ffffff	Couleur HEX de fond. Gardez-la plus claire que les modules.
width_scale	integer	Non	2	Multiplicateur de largeur des barres, 1–10.
height	integer	Non	30	Hauteur des barres en pixels, 30–1000.
display_text	boolean	Non	false	Si true, value est imprimé sous les barres.

Exemple de requête

curl -X POST 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}'

Plus d'exemples

EAN-13

curl -X POST 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Retail EAN-13",
  "type": "EAN13",
  "value": "5901234123457",
  "height": 70,
  "display_text": true
}'

Exemple de réponse

{
  "data": {
    "id": 1,
    "type": "C128",
    "name": "Product SKU",
    "value": "FORQR-1001",
    "barcode": "https://…/barcodes/…/barcode.svg"
  }
}

GET/api/v1/barcodes

Lister code-barres

Nom	Type	Requis	Description
page	integer	Non	Page number (default 1)
results_per_page	integer	Non	Items per page (default 25, max 100)
search	string	Non	Search term
search_by	string	Non	Column to search
order_by	string	Non	Sort column
order_type	string	Non	asc or desc
datetime_start	string	Non	ISO datetime filter start
datetime_end	string	Non	ISO datetime filter end

curl -X GET 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET/api/v1/barcodes/{id}

Lire un code-barres

Nom	Type	Requis	Description
id	integer	Oui	—

curl -X GET 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

PATCH/api/v1/barcodes/{id}

Mettre à jour code-barres

Nom	Type	Requis	Par défaut	Description
id	integer	Oui	—	—
name	string	Non	—	Libellé enregistré sur la ressource.
type	string	Non	C128	Clé de symbologie telle que C128, EAN13 ou UPCA.
value	string	Non	—	Données encodées dans le code-barres. Doivent être valides pour le type choisi.
project_id	integer	Non	—	Projet auquel rattacher la ressource.
is_bulk	boolean	Non	false	Si true, un code-barres est créé par ligne dans value.
foreground_color	string	Non	#000000	Couleur des modules en HEX.
background_color	string	Non	#ffffff	Couleur HEX de fond. Gardez-la plus claire que les modules.
width_scale	integer	Non	2	Multiplicateur de largeur des barres, 1–10.
height	integer	Non	30	Hauteur des barres en pixels, 30–1000.
display_text	boolean	Non	false	Si true, value est imprimé sous les barres.

Exemple de requête

curl -X PATCH 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "value": "FORQR-2002",
  "height": 90
}'

DELETE/api/v1/barcodes/{id}

Supprimer code-barres

Nom	Type	Requis	Description
id	integer	Oui	—

curl -X DELETE 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Noms de paramètres et exemples JSON en anglais. Remplacez YOUR_API_KEY par votre clé.