QR 코드

모두 검색

엔드포인트

GET https://qrcloud.online/api/qr-codes/

예제

curl --request GET \
--url 'https://qrcloud.online/api/qr-codes/' \
--header 'Authorization: Bearer {api_key}' \

매개 변수	세부 사항	설명
search	선택사항 문자열	검색 문자열입니다.
search_by	선택사항 문자열	어떤 필드로 검색하시겠습니까. 허용된 값은: `name` 입니다.
type	선택사항 문자열	어떤 필드로 검색하시겠습니까. 허용된 값은: `text`, `url`, `phone`, `sms`, `email`, `whatsapp`, `facetime`, `location`, `wifi`, `event`, `vcard`, `crypto`, `paypal`, `upi`, `epc`, `pix` 입니다.
datetime_field	선택사항 문자열	허용된 값: `datetime`, `last_datetime`
datetime_start	선택사항 문자열	이 날짜 및 시간부터 결과를 필터링합니다. `Y-m-d H:i:s` 형식.
datetime_end	선택사항 문자열	이 날짜 및 시간까지 결과를 필터링합니다. `Y-m-d H:i:s` 형식.
order_by	선택사항 문자열	결과를 어떤 필드로 정렬할 지 지정합니다. 허용되는 값은: `qr_code_id`, `datetime`, `last_datetime`, `name`, `type`입니다.
order_type	선택사항 문자열	결과의 정렬 순서입니다. 허용된 값은: `ASC`는 오름차순 정렬, 그리고 `DESC`는 내림차순 정렬입니다.
page	선택사항 정수	원하는 결과가 있는 페이지 번호. 기본값은 `1`입니다.
results_per_page	선택사항 정수	한 페이지 당 원하는 결과 수는 몇 개입니까. 허용된 값은: `10`, `25`, `50`, `100`, `250`, `500`, `1000`입니다. 기본값은 `25`입니다.

응답 예제

{
    "data": [
        {
            "id": 1,
            "type": "url",
            "name": "Example name",
            "qr_code": "https://qrcloud.online/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-29 21:08:01",
        },
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://qrcloud.online/api/qr-codes?page=1",
        "last": "https://qrcloud.online/api/qr-codes?page=1",
        "next": null,
        "prev": null,
        "self": "https://qrcloud.online/api/qr-codes?page=1"
    }
}

한 개를 검색하세요

엔드포인트

GET https://qrcloud.online/api/qr-codes/{qr_code_id}

예제

curl --request GET \
--url 'https://qrcloud.online/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \

응답 예제

{
    "data": {
        "id": 1,
        "type": "url",
        "name": "Example name",
        "qr_code": "https://qrcloud.online/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-29 21:08:01",
    }
}

curl --request POST \
--url 'https://qrcloud.online/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://qrcloud.online/api/qr-codes/{qr_code_id}

매개 변수	세부 사항	설명
link_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
email_subject	선택사항 문자열	이용 가능 시간: type = email
email_body	선택사항 문자열	이용 가능 시간: 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://qrcloud.online/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://qrcloud.online/api/qr-codes/{qr_code_id}

예제

curl --request DELETE \
--url 'https://qrcloud.online/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \

QR 코드

모두 검색

한 개를 검색하세요

만들기

업데이트

삭제