Codici a barre

Crea codici a barre su 34 simbologie, con colore, dimensione ed etichetta.

Tipi supportati

Passa type come una di queste chiavi di simbologia. value deve rispettare le regole di quel tipo.

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

Crea codice a barre

Invia JSON con name, type e value. type è una chiave di simbologia come C128 o EAN13. Colori, width_scale, height e display_text controllano l'immagine renderizzata.

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
name	string	Sì	—	Etichetta salvata sulla risorsa.
type	string	Sì	C128	Chiave di simbologia come C128, EAN13 o UPCA.
value	string	Sì	—	Dati codificati nel codice a barre. Devono essere validi per il tipo scelto.
project_id	integer	No	—	Progetto a cui collegare la risorsa.
is_bulk	boolean	No	false	Se true, viene creato un codice a barre per ogni riga in value.
foreground_color	string	No	#000000	Colore dei moduli in HEX.
background_color	string	No	#ffffff	Colore HEX di sfondo. Tienilo più chiaro dei moduli.
width_scale	integer	No	2	Moltiplicatore della larghezza delle barre, 1–10.
height	integer	No	30	Altezza delle barre in pixel, 30–1000.
display_text	boolean	No	false	Se true, value viene stampato sotto le barre.

Esempio di richiesta

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
}'

Altri esempi

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
}'

Esempio di risposta

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

GET/api/v1/barcodes

Elenca codice a barre

Nome	Tipo	Obbligatorio	Descrizione
page	integer	No	Page number (default 1)
results_per_page	integer	No	Items per page (default 25, max 100)
search	string	No	Search term
search_by	string	No	Column to search
order_by	string	No	Sort column
order_type	string	No	asc or desc
datetime_start	string	No	ISO datetime filter start
datetime_end	string	No	ISO datetime filter end

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

GET/api/v1/barcodes/{id}

Leggi un codice a barre

Nome	Tipo	Obbligatorio	Descrizione
id	integer	Sì	—

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

PATCH/api/v1/barcodes/{id}

Aggiorna codice a barre

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
id	integer	Sì	—	—
name	string	No	—	Etichetta salvata sulla risorsa.
type	string	No	C128	Chiave di simbologia come C128, EAN13 o UPCA.
value	string	No	—	Dati codificati nel codice a barre. Devono essere validi per il tipo scelto.
project_id	integer	No	—	Progetto a cui collegare la risorsa.
is_bulk	boolean	No	false	Se true, viene creato un codice a barre per ogni riga in value.
foreground_color	string	No	#000000	Colore dei moduli in HEX.
background_color	string	No	#ffffff	Colore HEX di sfondo. Tienilo più chiaro dei moduli.
width_scale	integer	No	2	Moltiplicatore della larghezza delle barre, 1–10.
height	integer	No	30	Altezza delle barre in pixel, 30–1000.
display_text	boolean	No	false	Se true, value viene stampato sotto le barre.

Esempio di richiesta

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}

Elimina codice a barre

Nome	Tipo	Obbligatorio	Descrizione
id	integer	Sì	—

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

Nomi dei parametri ed esempi JSON sono in inglese. Sostituisci YOUR_API_KEY con la chiave del tuo account.