Tài liệu API
QR code
Liệt kê, kiểm tra, tạo, cập nhật và xóa QR code của bạn.
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/qr-codes/
Ví dụ
curl --request GET \
--url 'https://rqrcode.com/api/qr-codes/' \
--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": "url",
"name": "Tên ví dụ",
"qr_code": "https://rqrcode.com/uploads/qr_code/example.svg",
"qr_code_logo": null,
"qr_code_background": null,
"settings": {
"foreground_type": "color",
"foreground_color": "#000000",
"background_color": "#ffffff",
"custom_eyes_color": false,
"qr_code_logo_size": 25,
"size": 500,
"margin": 0,
"ecc": "L",
"url": "https://example.com",
"...": "..."
},
"embedded_data": "https://example.com",
"last_datetime": null,
"datetime": "2026-04-20 07:52:15"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://rqrcode.com/api/qr-codes?page=1",
"last": "https://rqrcode.com/api/qr-codes?page=1",
"next": null,
"prev": null,
"self": "https://rqrcode.com/api/qr-codes?page=1"
}
}
Endpoint API
GET https://rqrcode.com/api/qr-codes/{qr_code_id}
Ví dụ
curl --request GET \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_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": "url",
"name": "Tên ví dụ",
"qr_code": "https://rqrcode.com/uploads/qr_code/example.svg",
"qr_code_logo": null,
"qr_code_background": null,
"settings": {
"foreground_type": "color",
"foreground_color": "#000000",
"background_color": "#ffffff",
"custom_eyes_color": false,
"qr_code_logo_size": 25,
"size": 500,
"margin": 0,
"ecc": "L",
"url": "https://example.com",
"...": "..."
},
"embedded_data": "https://example.com",
"last_datetime": null,
"datetime": "2026-04-20 07:52:15"
}
}
Endpoint API
POST https://rqrcode.com/api/qr-codes
Ví dụ
curl --request POST \
--url 'https://rqrcode.com/api/qr-codes' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Hà Nội' \
--form 'type=text' \
--form 'text=Xin chào!'
Tham số
| Tham số | Chi tiết | Mô tả |
|---|---|---|
| link_id |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
Không có 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: text, url, pdf, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix, coupon, google_review |
| is_bulk |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Khả dụng khi: type = text |
| style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: square, dot, round, rounded, elastic_square, heart, diamond, star, triangle, hexagon, spaced_square, octagon, cross_x, curvy_x, rounded_cross, ninja, sun, shine, bold_plus, teardrop, corner_cut, randomized_square, bold_x |
| inner_eye_style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: square, dot, rounded, diamond, flower, leaf |
| outer_eye_style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: square, circle, rounded, flower, leaf |
| foreground_type |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: color, gradient |
| foreground_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: foreground_type = color |
| foreground_gradient_style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: vertical, horizontal, diagonal, inverse_diagonal, radial |
| foreground_gradient_one |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: foreground_type = gradient |
| foreground_gradient_two |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: foreground_type = gradient |
| background_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| background_color_transparency |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
Không có mô tả |
| custom_eyes_color |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Không có mô tả |
| eyes_inner_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: custom_eyes_color = 1 |
| eyes_outer_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: custom_eyes_color = 1 |
| qr_code_logo |
Tùy chọn
ui.admin.api_docs.common.types.Tệp
|
Không có mô tả |
| qr_code_logo_size |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
5-35 |
| qr_code_background |
Tùy chọn
ui.admin.api_docs.common.types.Tệp
|
Không có mô tả |
| qr_code_background_transparency |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
0-100 |
| qr_code_foreground |
Tùy chọn
ui.admin.api_docs.common.types.Tệp
|
Không có mô tả |
| qr_code_foreground_transparency |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
0-100 |
| frame |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: circle_simple_bottom_text, round_simple_bottom_text, straight_simple_bottom_text, round_card_bottom_text, straight_bottom_text, straight_top_text, round_bottom_text, round_top_text, tooltip_bottom_text, tooltip_top_text, ribbon_bottom_text, ribbon_top_text, tooltip_snap_top_text, tooltip_snap_bottom_text, straight_semi_bordered_bottom_text, round_semi_bordered_bottom_text, hand_arrows_bottom_text, broken_ticket_bottom_text, smooth_ribbon_bottom_text |
| frame_text |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| frame_text_size |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
-5 - 5 |
| frame_text_font |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: times_new_roman, georgia, courier, arial, helvetica, verdana, tahoma, trebuchet_ms, courier_new, monaco, comic_sans_ms, impact, luminari, baskerville, papyrus, brush_script_mt |
| frame_custom_colors |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Không có mô tả |
| frame_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: frame_custom_colors = 1 |
| frame_text_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: frame_custom_colors = 1 |
| size |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
50-2000 |
| margin |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
0-25 |
| ecc |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: L, M, Q, H |
| text |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = text |
| url |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = url |
| phone |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = phone |
| sms |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = sms |
|
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = email | |
|
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = whatsapp | |
| facetime |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = facetime |
| event |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = event |
| location |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| wifi |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| crypto |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| vcard |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| paypal |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| upi |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| epc |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| pix |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| coupon |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| google_review |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
Ví dụ phản hồi
{
"data": {
"id": 1
}
}
Endpoint API
POST https://rqrcode.com/api/qr-codes/{qr_code_id}
Ví dụ
curl --request POST \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Đà Nẵng'
Tham số
| Tham số | Chi tiết | Mô tả |
|---|---|---|
| link_id |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
Không có mô tả |
| project_id |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
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: text, url, pdf, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix, coupon, google_review |
| style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: square, dot, round, rounded, elastic_square, heart, diamond, star, triangle, hexagon, spaced_square, octagon, cross_x, curvy_x, rounded_cross, ninja, sun, shine, bold_plus, teardrop, corner_cut, randomized_square, bold_x |
| inner_eye_style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: square, dot, rounded, diamond, flower, leaf |
| outer_eye_style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: square, circle, rounded, flower, leaf |
| foreground_type |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: color, gradient |
| foreground_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: foreground_type = color |
| foreground_gradient_style |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: vertical, horizontal, diagonal, inverse_diagonal, radial |
| foreground_gradient_one |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: foreground_type = gradient |
| foreground_gradient_two |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: foreground_type = gradient |
| background_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| background_color_transparency |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
0 - 100 |
| custom_eyes_color |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Không có mô tả |
| eyes_inner_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: custom_eyes_color = 1 |
| eyes_outer_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: custom_eyes_color = 1 |
| qr_code_logo |
Tùy chọn
ui.admin.api_docs.common.types.Tệp
|
Không có mô tả |
| qr_code_logo_size |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
5-35 |
| qr_code_background |
Tùy chọn
ui.admin.api_docs.common.types.Tệp
|
Không có mô tả |
| qr_code_background_transparency |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
0-100 |
| qr_code_foreground |
Tùy chọn
ui.admin.api_docs.common.types.Tệp
|
Không có mô tả |
| qr_code_foreground_transparency |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
0-100 |
| frame |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: circle_simple_bottom_text, round_simple_bottom_text, straight_simple_bottom_text, round_card_bottom_text, straight_bottom_text, straight_top_text, round_bottom_text, round_top_text, tooltip_bottom_text, tooltip_top_text, ribbon_bottom_text, ribbon_top_text, tooltip_snap_top_text, tooltip_snap_bottom_text, straight_semi_bordered_bottom_text, round_semi_bordered_bottom_text, hand_arrows_bottom_text, broken_ticket_bottom_text, smooth_ribbon_bottom_text |
| frame_text |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Không có mô tả |
| frame_text_size |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
-5 -> 5 |
| frame_text_font |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: times_new_roman, georgia, courier, arial, helvetica, verdana, tahoma, trebuchet_ms, courier_new, monaco, comic_sans_ms, impact, luminari, baskerville, papyrus, brush_script_mt |
| frame_custom_colors |
Tùy chọn
ui.admin.api_docs.common.types.Kiểu boolean
|
Không có mô tả |
| frame_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: frame_custom_colors = 1 |
| frame_text_color |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: frame_custom_colors = 1 |
| size |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
50-2000 |
| margin |
Tùy chọn
ui.admin.api_docs.common.types.Số nguyên
|
0-25 |
| ecc |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Giá trị được phép: L, M, Q, H |
| text |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = text |
| url |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = url |
| phone |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = phone |
| sms |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = sms |
|
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = email | |
|
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = whatsapp | |
| facetime |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = facetime |
| event |
Tùy chọn
ui.admin.api_docs.common.types.Chuỗi
|
Khả dụng khi: type = event |
| location |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| wifi |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| crypto |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| vcard |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| paypal |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| upi |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| epc |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| pix |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| coupon |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
| google_review |
Tùy chọn
ui.admin.api_docs.common.types.Đối tượng
|
Không có mô tả |
Ví dụ phản hồi
{
"data": {
"id": 1
}
}
Endpoint API
DELETE https://rqrcode.com/api/qr-codes/{qr_code_id}
Ví dụ
curl --request DELETE \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_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.