Tài liệu API
Mã vạch
Quản lý mã vạch và cài đặt xuất của chúng.
Xác thực
Mỗi yêu cầu phải gửi header Authorization với token Bearer khớp với khóa API quản trị.
Lấy khóa API.
Endpoint API
GET https://rqrcode.com/api/barcodes/
Ví dụ
curl --request GET \
--url 'https://rqrcode.com/api/barcodes/' \
--header 'Authorization: Bearer {api_key}'
Tham số
| Tham số | Chi tiết | Mô tả |
|---|---|---|
| page |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
Số trang mà bạn muốn lấy kết quả. Mặc định là 1. |
| results_per_page |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
Số kết quả bạn muốn trên mỗi trang. Giá trị được phép: 10, 25, 50, 100, 250, 500, 1000. Mặc định là 25. |
Ví dụ phản hồi
{
"data": [
{
"id": 1,
"type": "C32",
"name": "Tên ví dụ",
"value": "123456",
"barcode": "https://rqrcode.com/uploads/barcode/example.svg",
"settings": {
"foreground_color": "#000000",
"width_scale": 2,
"height": 50
},
"embedded_data": "123456",
"last_datetime": null,
"datetime": "2026-04-20 07:52:55"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://rqrcode.com/api/barcodes?page=1",
"last": "https://rqrcode.com/api/barcodes?page=1",
"next": null,
"prev": null,
"self": "https://rqrcode.com/api/barcodes?page=1"
}
}
Endpoint API
GET https://rqrcode.com/api/barcodes/{barcode_id}
Ví dụ
curl --request GET \
--url 'https://rqrcode.com/api/barcodes/{barcode_id}' \
--header 'Authorization: Bearer {api_key}'
Tham số
Không có tham số bổ sung.
Ví dụ phản hồi
{
"data": {
"id": 1,
"type": "C32",
"name": "Tên ví dụ",
"value": "123456",
"barcode": "https://rqrcode.com/uploads/barcode/example.svg",
"settings": {
"foreground_color": "#000000",
"width_scale": 2,
"height": 50
},
"embedded_data": "123456",
"last_datetime": null,
"datetime": "2026-04-20 07:52:55"
}
}
Endpoint API
POST https://rqrcode.com/api/barcodes
Ví dụ
curl --request POST \
--url 'https://rqrcode.com/api/barcodes' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Hà Nội' \
--form 'type=C32' \
--form 'value=123456'
Tham số
| Tham số | Chi tiết | Mô tả |
|---|---|---|
| project_id |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
Không có mô tả |
| name |
Bắt buộc
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| type |
Bắt buộc
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: 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 |
| is_bulk |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Không có mô tả |
| value |
Bắt buộc
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| display_text |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Không có mô tả |
| foreground_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| background_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| width_scale |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
1-10 |
| height |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
30-1000 |
Ví dụ phản hồi
{
"data": {
"id": 1
}
}
Endpoint API
POST https://rqrcode.com/api/barcodes/{barcode_id}
Ví dụ
curl --request POST \
--url 'https://rqrcode.com/api/barcodes/{barcode_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Đà Nẵng' \
--form 'value=123456'
Tham số
| Tham số | Chi tiết | Mô tả |
|---|---|---|
| project_id |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
Không có mô tả |
| name |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| type |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: 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 |
| value |
Bắt buộc
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| display_text |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Không có mô tả |
| foreground_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| background_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| width_scale |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
1-10 |
| height |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
30-1000 |
Ví dụ phản hồi
{
"data": {
"id": 1
}
}
Endpoint API
DELETE https://rqrcode.com/api/barcodes/{barcode_id}
Ví dụ
curl --request DELETE \
--url 'https://rqrcode.com/api/barcodes/{barcode_id}' \
--header 'Authorization: Bearer {api_key}'
Tham số
Không có tham số bổ sung.
Ví dụ phản hồi
Nội dung phản hồi 200 trống khi thành công.