Mã QR

GET https://addme.vn/api/qr-codes/
curl --request GET \
--url 'https://addme.vn/api/qr-codes/' \
--header 'Authorization: Bearer {api_key}' \
Thông số Details Description
search Optional Chuỗi Chuỗi tìm kiếm.
search_by Optional Chuỗi Bạn đang tìm kiếm theo lĩnh vực nào. Các giá trị được phép là: name.
project_id Optional Số nguyên
type Optional Chuỗi Bạn đang tìm kiếm theo lĩnh vực nào. Các giá trị được phép là: text , url , phone , sms , email , whatsapp , facetime , location , wifi , event , vcard , crypto , paypal.
order_by Optional Chuỗi Sắp xếp kết quả theo trường nào. Các giá trị được phép là: qr_code_id , datetime , last_datetime , name , type.
order_type Optional Chuỗi Thứ tự của kết quả. Các giá trị được phép là: ASC cho thứ tự tăng dần và DESC cho thứ tự giảm dần.
page Optional Số nguyên Số trang mà bạn muốn lấy kết quả. Mặc định là 1.
results_per_page Optional Số nguyên Bạn muốn có bao nhiêu kết quả trên mỗi trang. Các giá trị được phép là: 10 , 25 , 50 , 100 , 250 , 500 , 1000. Mặc định là 25.
{
    "data": [
        {
            "id": 1,
            "type": "url",
            "name": "Example name",
            "qr_code": "https://addme.vn/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-03-23 11:57:02",
        },
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://addme.vn/api/qr-codes?page=1",
        "last": "https://addme.vn/api/qr-codes?page=1",
        "next": null,
        "prev": null,
        "self": "https://addme.vn/api/qr-codes?page=1"
    }
}
GET https://addme.vn/api/qr-codes/{qr_code_id}
curl --request GET \
--url 'https://addme.vn/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \
{
    "data": {
        "id": 1,
        "type": "url",
        "name": "Example name",
        "qr_code": "https://addme.vn/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-03-23 11:57:02",
    }
}
POST https://addme.vn/api/qr-codes
Thông số Details Description
project_id Optional Số nguyên -
name Bắt buộc Chuỗi -
type Bắt buộc Chuỗi Giá trị được phép: text, url, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal
is_bulk Optional Boolean Available when: type = text
style Optional Chuỗi
inner_eye_style Optional Chuỗi Giá trị được phép: square, dot, rounded, diamond, flower, leaf
outer_eye_style Optional Chuỗi Giá trị được phép: square, circle, rounded, flower, leaf
foreground_type Optional Chuỗi Giá trị được phép: color, gradient
foreground_color Optional Chuỗi Available when: foreground_type = color
foreground_gradient_style Optional Chuỗi Giá trị được phép: vertical, horizontal, diagonal, inverse_diagonal, radial
foreground_gradient_one Optional Chuỗi Available when: foreground_type = gradient
foreground_gradient_two Optional Chuỗi Available when: foreground_type = gradient
background_color Optional Chuỗi
background_color_transparency Optional Số nguyên
custom_eyes_color Optional Boolean
eyes_inner_color Optional Chuỗi Available when: custom_eyes_color = 1
eyes_outer_color Optional Chuỗi Available when: custom_eyes_color = 1
qr_code_logo Optional Tệp -
qr_code_logo_size Optional Số nguyên 5-35
qr_code_background Optional Tệp -
qr_code_background_transparency Optional Số nguyên 0-100
qr_code_foreground Optional Tệp -
qr_code_foreground_transparency Optional Số nguyên 0-100
frame Optional 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 Optional Chuỗi
frame_text_size Optional Số nguyên -5 - 5
frame_text_font Optional 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 Optional Boolean
frame_color Optional Chuỗi Available when: frame_custom_colors = 1
frame_text_color Optional Chuỗi Available when: frame_custom_colors = 1
size Optional Số nguyên 50-2000
margin Optional Số nguyên 0-25
ecc Optional Chuỗi Giá trị được phép: L, M, Q, H
text Optional Chuỗi Available when: type = text
url Optional Chuỗi Available when: type = url
phone Optional Chuỗi Available when: type = phone
sms Optional Chuỗi Available when: type = sms
sms_body Optional Chuỗi Available when: type = sms
email Optional Chuỗi Available when: type = email
whatsapp Optional Chuỗi Available when: type = whatsapp
whatsapp_body Optional Chuỗi Available when: type = whatsapp
facetime Optional Chuỗi Available when: type = facetime
location
location_latitude Optional Float Available when: type = location
location_longitude Optional Float Available when: type = location
wifi
wifi_ssid Optional Chuỗi Available when: type = wifi
wifi_encryption Optional Chuỗi Giá trị được phép: nopass, WEP, WPA/WPA2, H (type=wifi)
wifi_password Optional Chuỗi Available when: type = wifi
wifi_is_hidden Optional Boolean Available when: type = wifi
event Optional Chuỗi Available when: type = event
event_location Optional Chuỗi Available when: type = event
event_url Optional Chuỗi Available when: type = event
event_note Optional Chuỗi Available when: type = event
event_timezone Optional Chuỗi Available when: type = event
event_start_datetime Optional Chuỗi Available when: type = event
event_end_datetime Optional Chuỗi Available when: type = event
event_first_alert_datetime Optional Chuỗi Available when: type = event
event_second_alert_datetime Optional Chuỗi Available when: type = event
crypto
crypto_coin Optional Chuỗi Available when: type = crypto
crypto_address Optional Chuỗi Available when: type = crypto
crypto_amount Optional Chuỗi Available when: type = crypto
vcard
vcard_first_name Optional Chuỗi Available when: type = vcard
vcard_last_name Optional Chuỗi Available when: type = vcard
vcard_company Optional Chuỗi Available when: type = vcard
vcard_phone_number_label[index] Optional Chuỗi Available when: type = vcard
vcard_phone_number_value[index] Optional Chuỗi Available when: type = vcard
vcard_email Optional Chuỗi Available when: type = vcard
vcard_url Optional Chuỗi Available when: type = vcard
vcard_job_title Optional Chuỗi Available when: type = vcard
vcard_birthday Optional Chuỗi Available when: type = vcard
vcard_street Optional Chuỗi Available when: type = vcard
vcard_city Optional Chuỗi Available when: type = vcard
vcard_zip Optional Chuỗi Available when: type = vcard
vcard_region Optional Chuỗi Available when: type = vcard
vcard_country Optional Chuỗi Available when: type = vcard
vcard_note Optional Chuỗi Available when: type = vcard
vcard_social_label[index] Optional Chuỗi Available when: type = vcard
vcard_social_value[index] Optional Chuỗi Available when: type = vcard
paypal
paypal_type Optional Chuỗi Giá trị được phép: buy_now, add_to_cart, donation (type=paypal)
paypal_email Optional Chuỗi Available when: type = paypal
paypal_title Optional Chuỗi Available when: type = paypal
paypal_currency Optional Chuỗi Available when: type = paypal
paypal_price Optional Float Available when: type = paypal
paypal_thank_you_url Optional Chuỗi Available when: type = paypal
paypal_cancel_url Optional Chuỗi Available when: type = paypal
upi
upi_payee_id Optional Chuỗi Available when: type = upi
upi_payee_name Optional Chuỗi Available when: type = upi
upi_currency Optional Chuỗi Available when: type = upi
upi_amount Optional Float Available when: type = upi
upi_transaction_id Optional Chuỗi Available when: type = upi
upi_transaction_note Optional Chuỗi Available when: type = upi
upi_transaction_reference Optional Chuỗi Available when: type = upi
upi_thank_you_url Optional Chuỗi Available when: type = upi
epc
epc_iban Optional Chuỗi Available when: type = epc
epc_payee_name Optional Chuỗi Available when: type = epc
epc_currency Optional Chuỗi Available when: type = epc
epc_amount Optional Float Available when: type = epc
epc_bic Optional Chuỗi Available when: type = epc
epc_remittance_reference Optional Chuỗi Available when: type = epc
epc_remittance_text Optional Chuỗi Available when: type = epc
information Optional Chuỗi Available when: type = epc
pix
pix_payee_key Optional Chuỗi Available when: type = pix
pix_payee_name Optional Chuỗi Available when: type = pix
pix_currency Optional Chuỗi Available when: type = pix
pix_amount Optional Float Available when: type = pix
pix_city Optional Chuỗi Available when: type = pix
pix_transaction_id Optional Chuỗi Available when: type = pix
pix_description Optional Chuỗi Available when: type = pix
Thông số Details Description
curl --request POST \
--url 'https://addme.vn/api/qr-codes' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=New York' \
--form 'type=text' \
--form 'text=Hello!' \
{
    "data": {
        "id": 1
    }
}
POST https://addme.vn/api/qr-codes/{qr_code_id}
Thông số Details Description
project_id Optional Chuỗi -
name Optional Chuỗi -
type Optional Chuỗi Giá trị được phép: text, url, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal
style Optional 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 Optional Chuỗi Giá trị được phép: square, dot, rounded, diamond, flower, leaf
outer_eye_style Optional Chuỗi Giá trị được phép: square, circle, rounded, flower, leaf
foreground_type Optional Chuỗi Giá trị được phép: color, gradient
foreground_color Optional Chuỗi Available when: foreground_type = color
foreground_gradient_style Optional Chuỗi Giá trị được phép: vertical, horizontal, diagonal, inverse_diagonal, radial
foreground_gradient_one Optional Chuỗi Available when: foreground_type = gradient
foreground_gradient_two Optional Chuỗi Available when: foreground_type = gradient
background_color Optional Chuỗi
background_color_transparency Optional Số nguyên 0 - 100
custom_eyes_color Optional Boolean
eyes_inner_color Optional Chuỗi Available when: custom_eyes_color = 1
eyes_outer_color Optional Chuỗi Available when: custom_eyes_color = 1
qr_code_logo Optional Tệp -
qr_code_logo_size Optional Số nguyên 5-35
qr_code_background Optional Tệp -
qr_code_background_transparency Optional Số nguyên 0-100
qr_code_foreground Optional Tệp -
qr_code_foreground_transparency Optional Số nguyên 0-100
frame Optional 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 Optional Chuỗi
frame_text_size Optional Số nguyên -5 -> 5
frame_text_font Optional 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 Optional Boolean
frame_color Optional Chuỗi Available when: frame_custom_colors = 1
frame_text_color Optional Chuỗi Available when: frame_custom_colors = 1
size Optional Số nguyên 50-2000
margin Optional Số nguyên 0-25
ecc Optional Chuỗi Giá trị được phép: L, M, Q, H
text Optional Chuỗi Available when: type = text
url Optional Chuỗi Available when: type = url
phone Optional Chuỗi Available when: type = phone
sms Optional Chuỗi Available when: type = sms
sms_body Optional Chuỗi Available when: type = sms
email Optional Chuỗi Available when: type = email
whatsapp Optional Chuỗi Available when: type = whatsapp
whatsapp_body Optional Chuỗi Available when: type = whatsapp
facetime Optional Chuỗi Available when: type = facetime
location
location_latitude Optional Float Available when: type = location
location_longitude Optional Float Available when: type = location
wifi
wifi_ssid Optional Chuỗi Available when: type = wifi
wifi_encryption Optional Chuỗi Giá trị được phép: nopass, WEP, WPA/WPA2, H (type=wifi)
wifi_password Optional Chuỗi Available when: type = wifi
wifi_is_hidden Optional Boolean Available when: type = wifi
event Optional Chuỗi Available when: type = event
event_location Optional Chuỗi Available when: type = event
event_url Optional Chuỗi Available when: type = event
event_note Optional Chuỗi Available when: type = event
event_timezone Optional Chuỗi Available when: type = event
event_start_datetime Optional Chuỗi Available when: type = event
event_end_datetime Optional Chuỗi Available when: type = event
event_first_alert_datetime Optional Chuỗi Available when: type = event
event_second_alert_datetime Optional Chuỗi Available when: type = event
crypto
crypto_coin Optional Chuỗi Available when: type = crypto
crypto_address Optional Chuỗi Available when: type = crypto
crypto_amount Optional Chuỗi Available when: type = crypto
vcard
vcard_first_name Optional Chuỗi Available when: type = vcard
vcard_last_name Optional Chuỗi Available when: type = vcard
vcard_company Optional Chuỗi Available when: type = vcard
vcard_phone_number_label[index] Optional Chuỗi Available when: type = vcard
vcard_phone_number_value[index] Optional Chuỗi Available when: type = vcard
vcard_email Optional Chuỗi Available when: type = vcard
vcard_url Optional Chuỗi Available when: type = vcard
vcard_job_title Optional Chuỗi Available when: type = vcard
vcard_birthday Optional Chuỗi Available when: type = vcard
vcard_street Optional Chuỗi Available when: type = vcard
vcard_city Optional Chuỗi Available when: type = vcard
vcard_zip Optional Chuỗi Available when: type = vcard
vcard_region Optional Chuỗi Available when: type = vcard
vcard_country Optional Chuỗi Available when: type = vcard
vcard_note Optional Chuỗi Available when: type = vcard
vcard_social_label[index] Optional Chuỗi Available when: type = vcard
vcard_social_value[index] Optional Chuỗi Available when: type = vcard
paypal
paypal_type Optional Chuỗi Giá trị được phép: buy_now, add_to_cart, donation (type=paypal)
paypal_email Optional Chuỗi Available when: type = paypal
paypal_title Optional Chuỗi Available when: type = paypal
paypal_currency Optional Chuỗi Available when: type = paypal
paypal_price Optional Float Available when: type = paypal
paypal_thank_you_url Optional Chuỗi Available when: type = paypal
paypal_cancel_url Optional Chuỗi Available when: type = paypal
upi
upi_payee_id Optional Chuỗi Available when: type = upi
upi_payee_name Optional Chuỗi Available when: type = upi
upi_currency Optional Chuỗi Available when: type = upi
upi_amount Optional Float Available when: type = upi
upi_transaction_id Optional Chuỗi Available when: type = upi
upi_transaction_note Optional Chuỗi Available when: type = upi
upi_transaction_reference Optional Chuỗi Available when: type = upi
upi_thank_you_url Optional Chuỗi Available when: type = upi
epc
epc_iban Optional Chuỗi Available when: type = epc
epc_payee_name Optional Chuỗi Available when: type = epc
epc_currency Optional Chuỗi Available when: type = epc
epc_amount Optional Float Available when: type = epc
epc_bic Optional Chuỗi Available when: type = epc
epc_remittance_reference Optional Chuỗi Available when: type = epc
epc_remittance_text Optional Chuỗi Available when: type = epc
information Optional Chuỗi Available when: type = epc
pix
pix_payee_key Optional Chuỗi Available when: type = pix
pix_payee_name Optional Chuỗi Available when: type = pix
pix_currency Optional Chuỗi Available when: type = pix
pix_amount Optional Float Available when: type = pix
pix_city Optional Chuỗi Available when: type = pix
pix_transaction_id Optional Chuỗi Available when: type = pix
pix_description Optional Chuỗi Available when: type = pix
curl --request POST \
--url 'https://addme.vn/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Las Vegas' \
{
    "data": {
        "id": 1
    }
}
DELETE https://addme.vn/api/qr-codes/{qr_code_id}
curl --request DELETE \
--url 'https://addme.vn/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \