Códigos de barras

Crea códigos de barras en 34 simbologías, con color, tamaño y etiqueta.

Tipos admitidos

Pasa type como una de estas claves de simbología. value debe cumplir las reglas de ese 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

Crear código de barras

Envía JSON con name, type y value. type es una clave de simbología como C128 o EAN13. Los colores, width_scale, height y display_text controlan la imagen renderizada.

Nombre	Tipo	Obligatorio	Predeterminado	Descripción
name	string	Sí	—	Etiqueta guardada en el recurso.
type	string	Sí	C128	Clave de simbología como C128, EAN13 o UPCA.
value	string	Sí	—	Datos codificados en el código de barras. Deben ser válidos para el tipo elegido.
project_id	integer	No	—	Proyecto al que adjuntar el recurso.
is_bulk	boolean	No	false	Si es true, se crea un código de barras por cada línea de value.
foreground_color	string	No	#000000	Color de los módulos en HEX.
background_color	string	No	#ffffff	Color HEX de fondo. Manténlo más claro que los módulos.
width_scale	integer	No	2	Multiplicador del ancho de barras, 1–10.
height	integer	No	30	Alto de las barras en píxeles, 30–1000.
display_text	boolean	No	false	Si es true, value se imprime bajo las barras.

Ejemplo de solicitud

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

Más ejemplos

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

Ejemplo de respuesta

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

GET/api/v1/barcodes

Listar código de barras

Nombre	Tipo	Obligatorio	Descripción
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}

Leer un código de barras

Nombre	Tipo	Obligatorio	Descripción
id	integer	Sí	—

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

PATCH/api/v1/barcodes/{id}

Actualizar código de barras

Nombre	Tipo	Obligatorio	Predeterminado	Descripción
id	integer	Sí	—	—
name	string	No	—	Etiqueta guardada en el recurso.
type	string	No	C128	Clave de simbología como C128, EAN13 o UPCA.
value	string	No	—	Datos codificados en el código de barras. Deben ser válidos para el tipo elegido.
project_id	integer	No	—	Proyecto al que adjuntar el recurso.
is_bulk	boolean	No	false	Si es true, se crea un código de barras por cada línea de value.
foreground_color	string	No	#000000	Color de los módulos en HEX.
background_color	string	No	#ffffff	Color HEX de fondo. Manténlo más claro que los módulos.
width_scale	integer	No	2	Multiplicador del ancho de barras, 1–10.
height	integer	No	30	Alto de las barras en píxeles, 30–1000.
display_text	boolean	No	false	Si es true, value se imprime bajo las barras.

Ejemplo de solicitud

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}

Eliminar código de barras

Nombre	Tipo	Obligatorio	Descripción
id	integer	Sí	—

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

Los nombres de parámetros y ejemplos JSON se muestran en inglés. Sustituye YOUR_API_KEY por una clave de tu cuenta.