API 문서
QR 코드
QR 코드를 나열, 검사, 생성, 업데이트 및 삭제합니다.
인증
모든 요청은 관리자 API 키와 일치하는 Bearer 토큰을 Authorization 헤더로 보내야 합니다.
API 키 가져오기.
엔드포인트
GET https://rqrcode.com/api/qr-codes/
예시
curl --request GET \
--url 'https://rqrcode.com/api/qr-codes/' \
--header 'Authorization: Bearer {api_key}'
매개변수
| 매개변수 | 세부 정보 | 설명 |
|---|---|---|
| page |
선택 사항
ui.admin.api_docs.common.types.정수
|
결과를 얻고자 하는 페이지 번호입니다. 기본값은 1입니다. |
| results_per_page |
선택 사항
ui.admin.api_docs.common.types.정수
|
페이지당 원하는 결과 수입니다. 허용 값은 10, 25, 50, 100, 250, 500, 1000입니다. 기본값은 25입니다. |
응답 예시
{
"data": [
{
"id": 1,
"type": "url",
"name": "예제 이름",
"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"
}
}
엔드포인트
GET https://rqrcode.com/api/qr-codes/{qr_code_id}
예시
curl --request GET \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}'
매개변수
추가 매개변수가 없습니다.
응답 예시
{
"data": {
"id": 1,
"type": "url",
"name": "예제 이름",
"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"
}
}
엔드포인트
POST https://rqrcode.com/api/qr-codes
예시
curl --request POST \
--url 'https://rqrcode.com/api/qr-codes' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=뉴욕' \
--form 'type=text' \
--form 'text=안녕하세요!'
매개변수
| 매개변수 | 세부 정보 | 설명 |
|---|---|---|
| link_id |
선택 사항
ui.admin.api_docs.common.types.정수
|
설명 없음 |
| project_id |
선택 사항
ui.admin.api_docs.common.types.정수
|
설명 없음 |
| name |
필수
ui.admin.api_docs.common.types.문자열
|
설명 없음 |
| type |
필수
ui.admin.api_docs.common.types.문자열
|
허용 값: text, url, pdf, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix, coupon, google_review |
| is_bulk |
선택 사항
ui.admin.api_docs.common.types.부울
|
사용 가능: type = text |
| style |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: 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 |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: square, dot, rounded, diamond, flower, leaf |
| outer_eye_style |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: square, circle, rounded, flower, leaf |
| foreground_type |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: color, gradient |
| foreground_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: foreground_type = color |
| foreground_gradient_style |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: vertical, horizontal, diagonal, inverse_diagonal, radial |
| foreground_gradient_one |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: foreground_type = gradient |
| foreground_gradient_two |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: foreground_type = gradient |
| background_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
설명 없음 |
| background_color_transparency |
선택 사항
ui.admin.api_docs.common.types.정수
|
설명 없음 |
| custom_eyes_color |
선택 사항
ui.admin.api_docs.common.types.부울
|
설명 없음 |
| eyes_inner_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: custom_eyes_color = 1 |
| eyes_outer_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: custom_eyes_color = 1 |
| qr_code_logo |
선택 사항
ui.admin.api_docs.common.types.파일
|
설명 없음 |
| qr_code_logo_size |
선택 사항
ui.admin.api_docs.common.types.정수
|
5-35 |
| qr_code_background |
선택 사항
ui.admin.api_docs.common.types.파일
|
설명 없음 |
| qr_code_background_transparency |
선택 사항
ui.admin.api_docs.common.types.정수
|
0-100 |
| qr_code_foreground |
선택 사항
ui.admin.api_docs.common.types.파일
|
설명 없음 |
| qr_code_foreground_transparency |
선택 사항
ui.admin.api_docs.common.types.정수
|
0-100 |
| frame |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: 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 |
선택 사항
ui.admin.api_docs.common.types.문자열
|
설명 없음 |
| frame_text_size |
선택 사항
ui.admin.api_docs.common.types.정수
|
-5 - 5 |
| frame_text_font |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: 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 |
선택 사항
ui.admin.api_docs.common.types.부울
|
설명 없음 |
| frame_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: frame_custom_colors = 1 |
| frame_text_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: frame_custom_colors = 1 |
| size |
선택 사항
ui.admin.api_docs.common.types.정수
|
50-2000 |
| margin |
선택 사항
ui.admin.api_docs.common.types.정수
|
0-25 |
| ecc |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: L, M, Q, H |
| text |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = text |
| url |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = url |
| phone |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = phone |
| sms |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = sms |
|
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = email | |
|
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = whatsapp | |
| facetime |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = facetime |
| event |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = event |
| location |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| wifi |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| crypto |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| vcard |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| paypal |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| upi |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| epc |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| pix |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| coupon |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| google_review |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
응답 예시
{
"data": {
"id": 1
}
}
엔드포인트
POST https://rqrcode.com/api/qr-codes/{qr_code_id}
예시
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=라스베이거스'
매개변수
| 매개변수 | 세부 정보 | 설명 |
|---|---|---|
| link_id |
선택 사항
ui.admin.api_docs.common.types.정수
|
설명 없음 |
| project_id |
선택 사항
ui.admin.api_docs.common.types.문자열
|
설명 없음 |
| name |
선택 사항
ui.admin.api_docs.common.types.문자열
|
설명 없음 |
| type |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: text, url, pdf, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix, coupon, google_review |
| style |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: 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 |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: square, dot, rounded, diamond, flower, leaf |
| outer_eye_style |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: square, circle, rounded, flower, leaf |
| foreground_type |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: color, gradient |
| foreground_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: foreground_type = color |
| foreground_gradient_style |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: vertical, horizontal, diagonal, inverse_diagonal, radial |
| foreground_gradient_one |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: foreground_type = gradient |
| foreground_gradient_two |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: foreground_type = gradient |
| background_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
설명 없음 |
| background_color_transparency |
선택 사항
ui.admin.api_docs.common.types.정수
|
0 - 100 |
| custom_eyes_color |
선택 사항
ui.admin.api_docs.common.types.부울
|
설명 없음 |
| eyes_inner_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: custom_eyes_color = 1 |
| eyes_outer_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: custom_eyes_color = 1 |
| qr_code_logo |
선택 사항
ui.admin.api_docs.common.types.파일
|
설명 없음 |
| qr_code_logo_size |
선택 사항
ui.admin.api_docs.common.types.정수
|
5-35 |
| qr_code_background |
선택 사항
ui.admin.api_docs.common.types.파일
|
설명 없음 |
| qr_code_background_transparency |
선택 사항
ui.admin.api_docs.common.types.정수
|
0-100 |
| qr_code_foreground |
선택 사항
ui.admin.api_docs.common.types.파일
|
설명 없음 |
| qr_code_foreground_transparency |
선택 사항
ui.admin.api_docs.common.types.정수
|
0-100 |
| frame |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: 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 |
선택 사항
ui.admin.api_docs.common.types.문자열
|
설명 없음 |
| frame_text_size |
선택 사항
ui.admin.api_docs.common.types.정수
|
-5 -> 5 |
| frame_text_font |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: 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 |
선택 사항
ui.admin.api_docs.common.types.부울
|
설명 없음 |
| frame_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: frame_custom_colors = 1 |
| frame_text_color |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: frame_custom_colors = 1 |
| size |
선택 사항
ui.admin.api_docs.common.types.정수
|
50-2000 |
| margin |
선택 사항
ui.admin.api_docs.common.types.정수
|
0-25 |
| ecc |
선택 사항
ui.admin.api_docs.common.types.문자열
|
허용 값: L, M, Q, H |
| text |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = text |
| url |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = url |
| phone |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = phone |
| sms |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = sms |
|
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = email | |
|
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = whatsapp | |
| facetime |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = facetime |
| event |
선택 사항
ui.admin.api_docs.common.types.문자열
|
사용 가능: type = event |
| location |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| wifi |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| crypto |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| vcard |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| paypal |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| upi |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| epc |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| pix |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| coupon |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
| google_review |
선택 사항
ui.admin.api_docs.common.types.객체
|
설명 없음 |
응답 예시
{
"data": {
"id": 1
}
}
엔드포인트
DELETE https://rqrcode.com/api/qr-codes/{qr_code_id}
예시
curl --request DELETE \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}'
매개변수
추가 매개변수가 없습니다.
응답 예시
성공 시 빈 200 응답 본문입니다.