Mẫu tem
Mô tả
Các API hỗ trợ:
- GET /labelRegisters: Danh sách
- GET /forSelectBox: Select box
- GET /{id}: Chi tiết
- POST /designs: Tạo từ designer
- PUT /{id}/design: Cập nhật design
- DELETE /{id}: Xóa (soft)
API
GET /api/labelRegisters
Danh sách mẫu tem:
Tham số query:
| Tên trường | Kiểu dữ liệu | Mô tả | Bắt buộc |
|---|---|---|---|
name | string | Tên mẫu | Không |
status | string | Trạng thái | Không |
created_from | string | yyyy-MM-dd'T'HH:mm:ss | Không |
created_to | string | yyyy-MM-dd'T'HH:mm:ss | Không |
page | integer | Trang | Không |
size | integer | Số bản ghi trên trang | Không |
sort | string | Tên trường sắp xếp | Không |
order | string | asc / desc | Không |
GET /api/labelRegisters?page=1&size=10
Response Body
{
"code": 200,
"message": "Success",
"result": [],
"page": 1,
"page_size": 20,
"total": 0
}
GET /api/labelRegisters/forSelectBox
Mẫu tem cho select box.
GET /api/labelRegisters/forSelectBox
Response Body
{
"code": 200,
"message": "Success",
"result": {}
}
GET /api/labelRegisters/{id}
Chi tiết một mẫu tem (kèm layout designer).
GET /api/labelRegisters/\{id\}
Response Body
{
"code": 200,
"message": "Success",
"result": {}
}
POST /api/labelRegisters/designs
Tạo mẫu tem từ designer.
Request Body
| Tên trường | Kiểu dữ liệu | Mô tả | Bắt buộc |
|---|---|---|---|
name | string | Tên mẫu | Có |
width_mm | integer | Chiều rộng (mm) | Không |
height_mm | integer | Chiều cao (mm) | Không |
dpi | integer | DPI | Không |
printer_brand_code | string | Mã hãng máy in | Có |
is_rfid | boolean | Tem RFID? | Không |
rfid_field | string | Field RFID trong layout | Không |
layout_json | string | JSON layout designer | Có |
zpl | string | ZPL sinh từ layout | Có |
POST /api/labelRegisters/designs
Request Body
{
"name": "Tem S",
"width_mm": 50,
"height_mm": 30,
"dpi": 203,
"printer_brand_code": "zebra",
"is_rfid": true,
"layout_json": "{}",
"zpl": "^XA...^XZ"
}
Response Body
{
"code": 200,
"message": "Success",
"result": true
}
PUT /api/labelRegisters/{id}/design
Cập nhật design mẫu tem (cùng schema create).
Request Body
| Tên trường | Kiểu dữ liệu | Mô tả | Bắt buộc |
|---|---|---|---|
name | string | Tên mẫu | Có |
width_mm | integer | Chiều rộng (mm) | Không |
height_mm | integer | Chiều cao (mm) | Không |
dpi | integer | DPI | Không |
printer_brand_code | string | Mã hãng | Có |
is_rfid | boolean | Tem RFID? | Không |
rfid_field | string | Field RFID | Không |
layout_json | string | JSON layout | Có |
zpl | string | ZPL | Có |
PUT /api/labelRegisters/\{id\}/design
Request Body
{
"name": "Tem S",
"printer_brand_code": "zebra",
"layout_json": "{}",
"zpl": "^XA...^XZ"
}
Response Body
{
"code": 200,
"message": "Success",
"result": true
}
DELETE /api/labelRegisters/{id}
Xóa mềm mẫu tem.
DELETE /api/labelRegisters/\{id\}
Response Body
{
"code": 200,
"message": "Success",
"result": true
}