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.
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ên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
text | body|query | string | có | Nội dung cần mã hoá: ký tự ASCII in được, tối đa 80 ký tự. | |
format | body|query | string | không | svg | svg hoặc png. |
height | body|query | number | không | 80 | Chiều cao vạch tính bằng pixel (20–600). |
module_width | body|query | number | không | 2 | Độ rộng của vạch hẹp nhất, tính bằng pixel (1–10). |
color | body|query | string | không | 000000 | Màu vạch (hex hoặc tên màu cơ bản). |
background | body|query | string | không | ffffff | Màu nền. |
show_text | body|query | boolean | không | true | Hiệ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 outputconst res = await fetch('https://apibox.io.vn/v1/barcode?text=ABC-12345&height=80', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const blob = await res.blob();import requests
res = requests.get(
"https://apibox.io.vn/v1/barcode?text=ABC-12345&height=80",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
open("output", "wb").write(res.content)<?php
$ch = curl_init('https://apibox.io.vn/v1/barcode?text=ABC-12345&height=80');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
file_put_contents('output', $response);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
Tạo mã QR
Tạo mã QR dạng PNG hoặc SVG chỉ với một request GET: link, văn bản, WiFi, danh thiếp vCard, e-mail, SMS, số điện thoại, toạ độ. Tuỳ chỉnh màu, kích thước.
▭Ảnh placeholder
Lấy ảnh giữ chỗ đúng kích thước cho mockup và test: /v1/placeholder/600x400.png. Xuất SVG với chữ và màu tuỳ chỉnh, hoặc PNG một màu.
VQRTạo mã VietQR
Tạo mã QR chuyển khoản VietQR / NAPAS 247 với ngân hàng, số tài khoản, số tiền và nội dung chuyển khoản dạng PNG, SVG hoặc payload JSON. Giải mã VietQR có sẵn.