QR 코드

GET https://tistos.com/api/qr-codes/
curl --request GET \
--url 'https://tistos.com/api/qr-codes/' \
--header 'Authorization: Bearer {api_key}' \
매개변수 세부 정보 설명
page 선택 사항 정수 당신이 원하는 페이지 번호에서 결과를 얻습니다. 기본값은 1입니다.
results_per_page 선택 사항 정수 한 페이지당 원하는 결과 수를 입력하세요. 허용된 값은 10 , 25 , 50 , 100 , 250 , 500 , 1000입니다. 기본값은 25입니다.
{
    "data": [
        {
            "id": 1,
            "type": "url",
            "name": "Example name",
            "qr_code": "https://tistos.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": "2025-10-16 10:56:29",
        },
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://tistos.com/api/qr-codes?page=1",
        "last": "https://tistos.com/api/qr-codes?page=1",
        "next": null,
        "prev": null,
        "self": "https://tistos.com/api/qr-codes?page=1"
    }
}
GET https://tistos.com/api/qr-codes/{qr_code_id}
curl --request GET \
--url 'https://tistos.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \
{
    "data": {
        "id": 1,
        "type": "url",
        "name": "Example name",
        "qr_code": "https://tistos.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": "2025-10-16 10:56:29",
    }
}
POST https://tistos.com/api/qr-codes
매개변수 세부 정보 설명
project_id 선택 사항 정수 -
name 필수 문자열 -
type 필수 문자열 허용된 값: text, url, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix
is_bulk 선택 사항 부울 값 다음 시간에 이용 가능합니다: type = text
style 선택 사항 문자열
inner_eye_style 선택 사항 문자열 허용된 값: square, dot, rounded, diamond, flower, leaf
outer_eye_style 선택 사항 문자열 허용된 값: square, circle, rounded, flower, leaf
foreground_type 선택 사항 문자열 허용된 값: color, gradient
foreground_color 선택 사항 문자열 다음 시간에 이용 가능합니다: foreground_type = color
foreground_gradient_style 선택 사항 문자열 허용된 값: vertical, horizontal, diagonal, inverse_diagonal, radial
foreground_gradient_one 선택 사항 문자열 다음 시간에 이용 가능합니다: foreground_type = gradient
foreground_gradient_two 선택 사항 문자열 다음 시간에 이용 가능합니다: foreground_type = gradient
background_color 선택 사항 문자열
background_color_transparency 선택 사항 정수
custom_eyes_color 선택 사항 부울 값
eyes_inner_color 선택 사항 문자열 다음 시간에 이용 가능합니다: custom_eyes_color = 1
eyes_outer_color 선택 사항 문자열 다음 시간에 이용 가능합니다: custom_eyes_color = 1
qr_code_logo 선택 사항 파일 -
qr_code_logo_size 선택 사항 정수 5-35
qr_code_background 선택 사항 파일 -
qr_code_background_transparency 선택 사항 정수 0-100
qr_code_foreground 선택 사항 파일 -
qr_code_foreground_transparency 선택 사항 정수 0-100
frame 선택 사항 문자열 허용된 값: 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 선택 사항 문자열
frame_text_size 선택 사항 정수 -5 - 5
frame_text_font 선택 사항 문자열 허용된 값: 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 선택 사항 부울 값
frame_color 선택 사항 문자열 다음 시간에 이용 가능합니다: frame_custom_colors = 1
frame_text_color 선택 사항 문자열 다음 시간에 이용 가능합니다: frame_custom_colors = 1
size 선택 사항 정수 50-2000
margin 선택 사항 정수 0-25
ecc 선택 사항 문자열 허용된 값: L, M, Q, H
text 선택 사항 문자열 다음 시간에 이용 가능합니다: type = text
url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = url
phone 선택 사항 문자열 다음 시간에 이용 가능합니다: type = phone
sms 선택 사항 문자열 다음 시간에 이용 가능합니다: type = sms
sms_body 선택 사항 문자열 다음 시간에 이용 가능합니다: type = sms
email 선택 사항 문자열 다음 시간에 이용 가능합니다: type = email
whatsapp 선택 사항 문자열 다음 시간에 이용 가능합니다: type = whatsapp
whatsapp_body 선택 사항 문자열 다음 시간에 이용 가능합니다: type = whatsapp
facetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = facetime
location
location_latitude 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = location
location_longitude 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = location
wifi
wifi_ssid 선택 사항 문자열 다음 시간에 이용 가능합니다: type = wifi
wifi_encryption 선택 사항 문자열 허용된 값: nopass, WEP, WPA/WPA2, H (type=wifi)
wifi_password 선택 사항 문자열 다음 시간에 이용 가능합니다: type = wifi
wifi_is_hidden 선택 사항 부울 값 다음 시간에 이용 가능합니다: type = wifi
event 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_location 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_note 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_timezone 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_start_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_end_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_first_alert_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_second_alert_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
crypto
crypto_coin 선택 사항 문자열 다음 시간에 이용 가능합니다: type = crypto
crypto_address 선택 사항 문자열 다음 시간에 이용 가능합니다: type = crypto
crypto_amount 선택 사항 문자열 다음 시간에 이용 가능합니다: type = crypto
vcard
vcard_first_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_last_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_company 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_phone_number_label[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_phone_number_value[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_email 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_job_title 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_birthday 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_street 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_city 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_zip 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_region 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_country 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_note 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_social_label[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_social_value[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
paypal
paypal_type 선택 사항 문자열 허용된 값: buy_now, add_to_cart, donation (type=paypal)
paypal_email 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_title 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_price 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = paypal
paypal_thank_you_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_cancel_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
upi
upi_payee_id 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_payee_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_amount 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = upi
upi_transaction_id 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_transaction_note 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_transaction_reference 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_thank_you_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
epc
epc_iban 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_payee_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_amount 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = epc
epc_bic 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_remittance_reference 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_remittance_text 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
information 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
pix
pix_payee_key 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_payee_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_amount 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = pix
pix_city 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_transaction_id 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_description 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
매개변수 세부 정보 설명
curl --request POST \
--url 'https://tistos.com/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://tistos.com/api/qr-codes/{qr_code_id}
매개변수 세부 정보 설명
project_id 선택 사항 문자열 -
name 선택 사항 문자열 -
type 선택 사항 문자열 허용된 값: text, url, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix
style 선택 사항 문자열 허용된 값: 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 선택 사항 문자열 허용된 값: square, dot, rounded, diamond, flower, leaf
outer_eye_style 선택 사항 문자열 허용된 값: square, circle, rounded, flower, leaf
foreground_type 선택 사항 문자열 허용된 값: color, gradient
foreground_color 선택 사항 문자열 다음 시간에 이용 가능합니다: foreground_type = color
foreground_gradient_style 선택 사항 문자열 허용된 값: vertical, horizontal, diagonal, inverse_diagonal, radial
foreground_gradient_one 선택 사항 문자열 다음 시간에 이용 가능합니다: foreground_type = gradient
foreground_gradient_two 선택 사항 문자열 다음 시간에 이용 가능합니다: foreground_type = gradient
background_color 선택 사항 문자열
background_color_transparency 선택 사항 정수 0 - 100
custom_eyes_color 선택 사항 부울 값
eyes_inner_color 선택 사항 문자열 다음 시간에 이용 가능합니다: custom_eyes_color = 1
eyes_outer_color 선택 사항 문자열 다음 시간에 이용 가능합니다: custom_eyes_color = 1
qr_code_logo 선택 사항 파일 -
qr_code_logo_size 선택 사항 정수 5-35
qr_code_background 선택 사항 파일 -
qr_code_background_transparency 선택 사항 정수 0-100
qr_code_foreground 선택 사항 파일 -
qr_code_foreground_transparency 선택 사항 정수 0-100
frame 선택 사항 문자열 허용된 값: 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 선택 사항 문자열
frame_text_size 선택 사항 정수 -5 -> 5
frame_text_font 선택 사항 문자열 허용된 값: 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 선택 사항 부울 값
frame_color 선택 사항 문자열 다음 시간에 이용 가능합니다: frame_custom_colors = 1
frame_text_color 선택 사항 문자열 다음 시간에 이용 가능합니다: frame_custom_colors = 1
size 선택 사항 정수 50-2000
margin 선택 사항 정수 0-25
ecc 선택 사항 문자열 허용된 값: L, M, Q, H
text 선택 사항 문자열 다음 시간에 이용 가능합니다: type = text
url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = url
phone 선택 사항 문자열 다음 시간에 이용 가능합니다: type = phone
sms 선택 사항 문자열 다음 시간에 이용 가능합니다: type = sms
sms_body 선택 사항 문자열 다음 시간에 이용 가능합니다: type = sms
email 선택 사항 문자열 다음 시간에 이용 가능합니다: type = email
whatsapp 선택 사항 문자열 다음 시간에 이용 가능합니다: type = whatsapp
whatsapp_body 선택 사항 문자열 다음 시간에 이용 가능합니다: type = whatsapp
facetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = facetime
location
location_latitude 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = location
location_longitude 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = location
wifi
wifi_ssid 선택 사항 문자열 다음 시간에 이용 가능합니다: type = wifi
wifi_encryption 선택 사항 문자열 허용된 값: nopass, WEP, WPA/WPA2, H (type=wifi)
wifi_password 선택 사항 문자열 다음 시간에 이용 가능합니다: type = wifi
wifi_is_hidden 선택 사항 부울 값 다음 시간에 이용 가능합니다: type = wifi
event 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_location 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_note 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_timezone 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_start_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_end_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_first_alert_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
event_second_alert_datetime 선택 사항 문자열 다음 시간에 이용 가능합니다: type = event
crypto
crypto_coin 선택 사항 문자열 다음 시간에 이용 가능합니다: type = crypto
crypto_address 선택 사항 문자열 다음 시간에 이용 가능합니다: type = crypto
crypto_amount 선택 사항 문자열 다음 시간에 이용 가능합니다: type = crypto
vcard
vcard_first_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_last_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_company 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_phone_number_label[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_phone_number_value[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_email 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_job_title 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_birthday 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_street 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_city 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_zip 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_region 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_country 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_note 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_social_label[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
vcard_social_value[index] 선택 사항 문자열 다음 시간에 이용 가능합니다: type = vcard
paypal
paypal_type 선택 사항 문자열 허용된 값: buy_now, add_to_cart, donation (type=paypal)
paypal_email 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_title 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_price 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = paypal
paypal_thank_you_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
paypal_cancel_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = paypal
upi
upi_payee_id 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_payee_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_amount 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = upi
upi_transaction_id 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_transaction_note 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_transaction_reference 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
upi_thank_you_url 선택 사항 문자열 다음 시간에 이용 가능합니다: type = upi
epc
epc_iban 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_payee_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_amount 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = epc
epc_bic 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_remittance_reference 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
epc_remittance_text 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
information 선택 사항 문자열 다음 시간에 이용 가능합니다: type = epc
pix
pix_payee_key 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_payee_name 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_currency 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_amount 선택 사항 부동 소수점 다음 시간에 이용 가능합니다: type = pix
pix_city 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_transaction_id 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
pix_description 선택 사항 문자열 다음 시간에 이용 가능합니다: type = pix
curl --request POST \
--url 'https://tistos.com/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://tistos.com/api/qr-codes/{qr_code_id}
curl --request DELETE \
--url 'https://tistos.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \