Tài liệu API

Tạo mã vạch Code 128 và GS1 bằng lập trình. REST API đơn giản với phản hồi JSON và tải xuống hình ảnh.

Free: 100 req/ngày Business: 50.000 req/tháng

Bắt đầu nhanh

curl "https://www.barcode-code128.com/api/barcode/render?value=HELLO-WORLD&format=PNG&resolution=300" --output barcode.png

Điểm cuối

GET /api/barcode/render Tải xuống hình ảnh mã vạch

Tham số	Kiểu dữ liệu	Mặc định	Mô tả
value	string	—	Bắt buộc. Nội dung mã vạch cần mã hóa.
symbology	string	Code128Auto	Code128Auto, Code128A, Code128B, Code128C, GS1_128, GS1_DataMatrix, GS1_QR
format	string	PNG	PNG, SVG, PDF, EPS
resolution	int	300	DPI: 150, 300, 600, 1200
xDimension	decimal	0.33	Độ rộng mô-đun vạch tính bằng mm
barHeight	decimal	25.4	Chiều cao vạch tính bằng mm
showText	bool	true	Hiển thị văn bản đọc được dưới mã vạch
foregroundColor	string	#000000	Màu vạch (hex)
backgroundColor	string	#FFFFFF	Màu nền (hex)
barWidthReduction	decimal	0	Bù trừ độ rộng nét in tính bằng mm

POST /api/barcode/batch Tạo nhiều mã vạch dưới dạng ZIP

Gửi nội dung JSON kèm một mảng giá trị. Trả về tệp ZIP chứa một mã vạch cho mỗi giá trị.

{
  "values": ["SKU-001", "SKU-002", "SKU-003"],
  "symbology": "Code128Auto",
  "format": "PNG",
  "resolution": 300
}

POST /api/gs1/render Tạo mã vạch GS1 từ dữ liệu có cấu trúc

Gửi các trường mã định danh ứng dụng (AI) của GS1. API tự xử lý việc mã hóa, dấu phân cách FNC1 và chữ số kiểm tra.

{
  "fields": [
    { "ai": "01", "value": "05412345000013" },
    { "ai": "10", "value": "LOT-A23" },
    { "ai": "17", "value": "260731" }
  ],
  "symbology": "GS1_128",
  "format": "PNG",
  "resolution": 300
}

GET /api/barcode/quota Kiểm tra mức sử dụng hiện tại

{ "usedToday": 3, "dailyLimit": 5, "remaining": 2, "tier": "Free" }

Sân thử nghiệm

Dùng thử trực tiếp API — không cần đăng ký.

Giá trị

Định dạng

DPI

cURL

Ví dụ mã nguồn

cURL

curl "https://www.barcode-code128.com\
/api/barcode/render\
?value=SKU-4711\
&format=PNG\
&resolution=300" \
  --output barcode.png

Python

import requests

resp = requests.get(
    "https://www.barcode-code128.com"
    "/api/barcode/render",
    params={
        "value": "SKU-4711",
        "format": "PNG",
        "resolution": 300
    }
)

with open("barcode.png", "wb") as f:
    f.write(resp.content)

Node.js

const fs = require('fs');

const url = new URL(
  "https://www.barcode-code128.com"
  + "/api/barcode/render"
);
url.searchParams.set("value", "SKU-4711");
url.searchParams.set("format", "PNG");
url.searchParams.set("resolution", "300");

const resp = await fetch(url);
const buf = await resp.arrayBuffer();
fs.writeFileSync(
  "barcode.png",
  Buffer.from(buf)
);