Kody kreskowe

Twórz kody kreskowe w 34 symbologiach, z kolorem, rozmiarem i etykietą.

Obsługiwane typy

Przekaż type jako jeden z tych kluczy symbologii. value musi spełniać reguły danego typu.

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

Utwórz kod kreskowy

Wyślij JSON z name, type i value. type to klucz symbologii, np. C128 lub EAN13. Kolory, width_scale, height i display_text sterują renderowanym obrazem.

Nazwa	Typ	Wymagane	Domyślnie	Opis
name	string	Tak	—	Etykieta zapisana na zasobie.
type	string	Tak	C128	Klucz symbologii, np. C128, EAN13 lub UPCA.
value	string	Tak	—	Dane zakodowane w kodzie kreskowym. Muszą być poprawne dla wybranego typu.
project_id	integer	Nie	—	Projekt, do którego dołączyć zasób.
is_bulk	boolean	Nie	false	Jeśli true, powstaje jeden kod kreskowy na każdy wiersz w value.
foreground_color	string	Nie	#000000	Kolor modułów jako HEX.
background_color	string	Nie	#ffffff	Kolor HEX tła. Utrzymuj jaśniejszy niż moduły.
width_scale	integer	Nie	2	Mnożnik szerokości kresek, 1–10.
height	integer	Nie	30	Wysokość kresek w pikselach, 30–1000.
display_text	boolean	Nie	false	Jeśli true, value jest drukowane pod kreskami.

Przykład żądania

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

Więcej przykładów

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

Przykład odpowiedzi

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

GET/api/v1/barcodes

Lista kod kreskowy

Nazwa	Typ	Wymagane	Opis
page	integer	Nie	Page number (default 1)
results_per_page	integer	Nie	Items per page (default 25, max 100)
search	string	Nie	Search term
search_by	string	Nie	Column to search
order_by	string	Nie	Sort column
order_type	string	Nie	asc or desc
datetime_start	string	Nie	ISO datetime filter start
datetime_end	string	Nie	ISO datetime filter end

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

GET/api/v1/barcodes/{id}

Odczytaj jeden kod kreskowy

Nazwa	Typ	Wymagane	Opis
id	integer	Tak	—

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

PATCH/api/v1/barcodes/{id}

Aktualizuj kod kreskowy

Nazwa	Typ	Wymagane	Domyślnie	Opis
id	integer	Tak	—	—
name	string	Nie	—	Etykieta zapisana na zasobie.
type	string	Nie	C128	Klucz symbologii, np. C128, EAN13 lub UPCA.
value	string	Nie	—	Dane zakodowane w kodzie kreskowym. Muszą być poprawne dla wybranego typu.
project_id	integer	Nie	—	Projekt, do którego dołączyć zasób.
is_bulk	boolean	Nie	false	Jeśli true, powstaje jeden kod kreskowy na każdy wiersz w value.
foreground_color	string	Nie	#000000	Kolor modułów jako HEX.
background_color	string	Nie	#ffffff	Kolor HEX tła. Utrzymuj jaśniejszy niż moduły.
width_scale	integer	Nie	2	Mnożnik szerokości kresek, 1–10.
height	integer	Nie	30	Wysokość kresek w pikselach, 30–1000.
display_text	boolean	Nie	false	Jeśli true, value jest drukowane pod kreskami.

Przykład żądania

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}

Usuń kod kreskowy

Nazwa	Typ	Wymagane	Opis
id	integer	Tak	—

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

Nazwy parametrów i przykłady JSON są po angielsku. Zamień YOUR_API_KEY na klucz konta.