Tạo mã vạch API

Tạo mã vạch Code 128 cho tem nhãn, mã SKU, vận đơn chỉ với một request. Xuất SVG kèm dòng chữ hoặc PNG, tuỳ chỉnh chiều cao, độ rộng và màu sắc.

GETPOSThttps://apibox.io.vn/v1/barcode

API tạo mã vạch sinh barcode chuẩn Code 128 – loại mã vạch tuyến tính phổ biến nhất trên tem vận chuyển, mã SKU trong kho, hoá đơn và nhãn tài sản nội bộ. Gọi GET /v1/barcode?text=ABC-12345 là nhận về ảnh SVG sắc nét; thêm format=png nếu cần ảnh bitmap.

Bộ mã hoá tự động chuyển giữa Code 128 bộ B (mọi ký tự ASCII in được) và bộ C (từng cặp chữ số), nhờ vậy chuỗi số dài cho mã vạch gọn hơn; chữ số kiểm tra cũng được tính sẵn. Nội dung tối đa 80 ký tự ASCII; ký tự có dấu hoặc không phải chữ Latin sẽ bị từ chối kèm thông báo lỗi rõ ràng.

Tuỳ chọn: chiều cao vạch height (20–600 px, mặc định 80), module_width (1–10 px cho mỗi vạch hẹp, mặc định 2), màu vạch color và màu nền background, cùng show_text=false để ẩn dòng chữ bên dưới mã SVG (ảnh PNG chỉ có các vạch).

Tham số

TênVị tríKiểuBắt buộcMặc định
textbody|querystringcóNội dung cần mã hoá: ký tự ASCII in được, tối đa 80 ký tự.
formatbody|querystringkhôngsvgsvg hoặc png.
heightbody|querynumberkhông80Chiều cao vạch tính bằng pixel (20–600).
module_widthbody|querynumberkhông2Độ rộng của vạch hẹp nhất, tính bằng pixel (1–10).
colorbody|querystringkhông000000Màu vạch (hex hoặc tên màu cơ bản).
backgroundbody|querystringkhôngffffffMàu nền.
show_textbody|querybooleankhôngtrueHiện dòng chữ dưới mã vạch (chỉ với SVG).

Ví dụ

curl "https://apibox.io.vn/v1/barcode?text=ABC-12345&height=80" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o output

Kết quả trả về

binary image/svg+xml (Code 128 barcode)

Ứng dụng

  • In tem vận chuyển, nhãn kho trực tiếp từ hệ thống đơn hàng
  • Tạo mã vạch SKU cho sản phẩm trên web bán hàng hoặc máy POS
  • Chèn mã vạch số hoá đơn, mã đơn hàng vào file PDF
  • Dán nhãn thiết bị, tài sản bằng mã nội bộ

Hỏi đáp

API tạo loại mã vạch nào?

Code 128 (bộ B và C, tự động chuyển đổi), đọc được bằng hầu hết máy quét cầm tay và camera. API không tạo EAN-13/UPC; với mã QR hãy dùng /v1/qr.

Có mã hoá được tiếng Việt có dấu không?

Không. Code 128 chỉ hỗ trợ ký tự ASCII in được (mã 32–126), nên API trả về lỗi invalid_text. Hãy bỏ dấu hoặc mã hoá một mã định danh thay thế.

Nên dùng SVG hay PNG để in?

SVG là ảnh vector, in ở kích thước nào cũng nét và có kèm dòng chữ. Dùng PNG khi máy in nhãn hoặc trình e-mail không hiển thị được SVG; chọn module_width 2–4 để máy quét đọc tốt.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →