Kod bar

Cipta kod bar merentas 34 simbologi, dengan pilihan warna, saiz dan label.

Jenis yang disokong

Hantar type sebagai salah satu kunci simbologi ini. value mesti menepati peraturan jenis itu.

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

Cipta kod bar

Hantar JSON dengan name, type dan value. type ialah kunci simbologi seperti C128 atau EAN13. Warna, width_scale, height dan display_text mengawal imej yang dijana.

Nama	Jenis	Diperlukan	Lalai	Penerangan
name	string	Ya	—	Label yang disimpan pada sumber.
type	string	Ya	C128	Kunci simbologi seperti C128, EAN13 atau UPCA.
value	string	Ya	—	Data yang dikodkan dalam kod bar. Mesti sah untuk jenis yang dipilih.
project_id	integer	Tidak	—	Projek untuk melampirkan sumber.
is_bulk	boolean	Tidak	false	Jika true, satu kod bar dicipta bagi setiap baris dalam value.
foreground_color	string	Tidak	#000000	Warna modul sebagai HEX.
background_color	string	Tidak	#ffffff	Warna HEX latar. Kekalkan lebih cerah daripada modul.
width_scale	integer	Tidak	2	Pengganda lebar bar, 1–10.
height	integer	Tidak	30	Tinggi bar dalam piksel, 30–1000.
display_text	boolean	Tidak	false	Jika true, value dicetak di bawah bar.

Contoh permintaan

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

Contoh lanjut

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

Contoh respons

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

GET/api/v1/barcodes

Senaraikan kod bar

Nama	Jenis	Diperlukan	Penerangan
page	integer	Tidak	Page number (default 1)
results_per_page	integer	Tidak	Items per page (default 25, max 100)
search	string	Tidak	Search term
search_by	string	Tidak	Column to search
order_by	string	Tidak	Sort column
order_type	string	Tidak	asc or desc
datetime_start	string	Tidak	ISO datetime filter start
datetime_end	string	Tidak	ISO datetime filter end

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

GET/api/v1/barcodes/{id}

Baca satu kod bar

Nama	Jenis	Diperlukan	Penerangan
id	integer	Ya	—

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

PATCH/api/v1/barcodes/{id}

Kemas kini kod bar

Nama	Jenis	Diperlukan	Lalai	Penerangan
id	integer	Ya	—	—
name	string	Tidak	—	Label yang disimpan pada sumber.
type	string	Tidak	C128	Kunci simbologi seperti C128, EAN13 atau UPCA.
value	string	Tidak	—	Data yang dikodkan dalam kod bar. Mesti sah untuk jenis yang dipilih.
project_id	integer	Tidak	—	Projek untuk melampirkan sumber.
is_bulk	boolean	Tidak	false	Jika true, satu kod bar dicipta bagi setiap baris dalam value.
foreground_color	string	Tidak	#000000	Warna modul sebagai HEX.
background_color	string	Tidak	#ffffff	Warna HEX latar. Kekalkan lebih cerah daripada modul.
width_scale	integer	Tidak	2	Pengganda lebar bar, 1–10.
height	integer	Tidak	30	Tinggi bar dalam piksel, 30–1000.
display_text	boolean	Tidak	false	Jika true, value dicetak di bawah bar.

Contoh permintaan

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}

Padam kod bar

Nama	Jenis	Diperlukan	Penerangan
id	integer	Ya	—

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

Nama parameter dan contoh JSON dipaparkan dalam bahasa Inggeris. Gantikan YOUR_API_KEY dengan kunci akaun anda.