개발자 QR 코드 API 가이드
QR 코드 API를 사용하면 사용자가 프로그래밍 방식으로 고품질 QR 코드를 생성하거나 대량의 QR 코드를 빠르게 생성할 수 있습니다. 자동 결제, 앱 통합, 제품 라벨 생성 등 다양한 사용 사례에 적합한 간단하고 효율적인 방법을 제공합니다. 이 API는 크기, 색상, 모양, 테두리, 유형 등 다양한 사용자 지정 옵션을 지원합니다. 개발자는 HTTP 요청을 수행하고 API 키를 제공하여 인증하거나, 제공되는 라이브러리를 사용하여 애플리케이션에 통합할 수 있습니다.
API 키
계정의 API 키는 계정 페이지에서 생성할 수 있습니다. API 키는 요청에 URL 매개변수로 포함되거나, 예: https://api.genqrcode.com/public/generate?apikey=YOUR_API_KEY, 또는 `GenQRCode-apikey` 헤더 내에 포함될 수 있습니다. 이 가이드의 나머지 부분에서는 헤더 사용을 가정하겠습니다. 이는 더 안전한 옵션이지만, 두 방법 모두 교환하여 사용할 수 있습니다. API 키는 비밀로 간주되어야 하며, 누구와도 공유하지 않아야 합니다.
요청 제한
API의 공정한 사용을 보장하기 위해 요청 제한이 적용됩니다. 무료 요금제는 시간당 180개의 토큰을 제공합니다. 일반 QR 코드는 각 1개의 토큰을 소비하며, 최대 시간당 180개를 생성할 수 있습니다. 이는 약 20초에 1개 QR 코드를 생성하는 속도와 동일합니다. 또한, 빠른 호출(Fast Call) 엔드포인트는 1/50개의 토큰을 소비하며, 이는 초당 2.5개의 QR 코드를 생성할 수 있는 속도입니다. 빠른 호출(Fast Call) 엔드포인트는 QR 코드의 사용자 정의가 필요하지 않을 때 권장됩니다. 토큰 제한을 초과하면 429 상태 코드가 반환되어 요청이 제한되었음을 나타냅니다.
여러 개의 계정을 사용하여 이러한 제한을 우회하는 것은 금지됩니다. 더 높은 한도가 필요한 경우, 가격 문의를 위해 당사에 연락해 주세요.
라이브러리
정적 QR 코드 API
QR 코드 유형
QR 코드 유형은 모든 QR 코드의 기본 요소입니다. 데이터가 인코딩되는 방식과 스캔 시 QR 코드의 동작을 결정합니다. 올바른 유형을 선택하는 것은 매우 중요하며, 이는 QR 코드의 기능에 직접적인 영향을 줍니다. 아래에서 선택할 수 있는 모든 유형을 확인할 수 있습니다.
Text
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 0 For a Text QR Code |
| text | String | false | QR 코드 내부의 텍스트. |
WiFi
| 매개변수 | 유형 | 선택 사항 | 설명 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| type | Int | false | Use 1 For a WiFi QR Code | ||||||
| network | String | false | Wi-Fi 네트워크 이름(SSID). | ||||||
| password | String | true | Wi-Fi 비밀번호. | ||||||
| hidden | String | true | Wi-Fi 네트워크가 숨겨져 있는지 여부. | ||||||
| encryption | String | true |
Wi-Fi 네트워크에서 사용되는 암호화 방식.
가능한 값
|
SMS
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 2 For a SMS QR Code |
| text | String | false | SMS 메시지 내용. |
| number | String | false | SMS 수신자 전화번호. |
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 3 For a Email QR Code |
| String | true | "받는 사람" 필드의 이메일 주소. | |
| email-cc | String | true | "cc" 필드에 이메일 주소를 입력하세요. |
| email-bcc | String | true | "숨은 참조" 필드에 이메일 주소를 입력하세요. |
| subject | String | true | 이메일 제목. |
| message | String | true | 이메일 메시지. |
Phone
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 4 For a Phone QR Code |
| number | String | false | 전화번호. |
Crypto
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 5 For a Crypto QR Code |
| cryptotype | String | false | 전송할 암호화폐 유형. |
| address | String | false | 수신자의 암호화폐 주소. |
| amount | String | true | 전송할 암호화폐 금액. |
vCard
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 6 For a vCard QR Code |
| vc_first_name | String | false | vCard의 이름. |
| vc_last_name | String | false | vCard의 성. |
| vc_company | String | true | 회사명. |
| vc_job | String | true | 직책. |
| vc_street | String | true | 거리 주소. |
| vc_city | String | true | 도시. |
| vc_state | String | true | 주/도. |
| vc_zip | String | true | 우편번호. |
| vc_country | String | true | 국가. |
| vc_phone | String | true | 전화번호. |
| vc_mobile | String | true | 휴대폰 번호. |
| vc_fax | String | true | 팩스 번호. |
| vc_website | String | true | 웹사이트 URL. |
| vc_email | String | true | 이메일 주소. |
| vc_note | String | true | 메모입니다. |
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 7 For a Whatsapp QR Code |
| number | String | false | WhatsApp 전화번호. |
| text | String | true | WhatsApp 메시지 내용. |
vEvent
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 8 For a vEvent QR Code |
| ve_summary | String | true | vEvent 요약. |
| ve_description | String | true | vEvent 설명. |
| ve_location | String | true | vEvent 위치. |
| ve_timezone | String | true | vEvent 시작 및 종료 시간의 시간대. 예: "Europe/Amsterdam" (암스테르담 시간대). |
| ve_url | String | true | vEvent의 URL. |
| ve_start | String | true | vEvent 종료 시간. 예: "20250101T083000" (2025년 1월 1일 오전 8시 30분). |
| ve_end | String | true | vEvent 시작 시간. 예: "20250101T093000" (2025년 1월 1일 오전 9시 30분). |
Geo
| 매개변수 | 유형 | 선택 사항 | 설명 |
|---|---|---|---|
| type | Int | false | Use 9 For a Geo QR Code |
| ge_latitude | String | false | 인코딩할 위도. |
| ge_longitude | String | false | 인코딩할 경도. |
예제 텍스트 QR 코드
| URL | https://api.genqrcode.com/public/generate |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY |
| 본문 | {
"type": 0,
"text": "https://genqrcode.com"
} |
| 응답 |  |
예제 Wi-Fi QR 코드
| URL | https://api.genqrcode.com/public/generate |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY |
| 본문 | {
"type": 1,
"network": "GenQRCode",
"password": false,
"hidden": false,
"encryption": "wpa"
} |
| 응답 |  |
일반 매개변수
사용 가능한 모든 일반 매개변수와 사용 방법을 설명합니다.
| 매개변수 | 유형 | 기본값 | 설명 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| imageformat | String | png |
QR 코드의 이미지 형식입니다.
가능한 값
|
||||||||||||||||||||
| bordersize | Int | 4 | QR 코드 주위의 테두리 크기. | ||||||||||||||||||||
| width | Int | 500 | QR 코드의 너비. 최대 크기 2000. | ||||||||||||||||||||
| height | Int | 500 | QR 코드의 높이. 최대 크기 2000. |
색상 매개변수
사용자 지정 가능한 색상 매개변수와 사용 방법을 설명합니다.
| 매개변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
| color | String | #000000 | QR 코드의 색상. 형식은 #RRGGBB 또는 #RRGGBBAA이어야 합니다. RGBA 값은 16진수 형식(00~FF)으로 입력됩니다. |
| custom_color_pattern | String | 1 | 사용할 색상 패턴입니다. 예를 들어, 색상이 #ff0000, #00ff00, #0000ff이고 패턴이 1,2,3,3,2,1이면 해당 순서대로 색상이 변경됩니다. 가이드에서 예제를 제공합니다. |
| background_color | String | #FFFFFF | QR 코드의 배경색입니다. 배경을 투명하게 하려면 알파 채널을 00으로 설정하세요. 예: #00000000. |
| inner_eye_color | String | #000000 | QR 코드 내부 눈(inner eye)의 색상. |
| outer_eye_color | String | #000000 | QR 코드 외부 눈(outer eye)의 색상. |
| frame_color | String | #000000 | QR 코드 주위 프레임의 색상. 이 효과를 적용하려면 프레임이 활성화되어 있어야 합니다. |
| frame_background_color | String | #FFFFFF | 프레임 배경 색상입니다. 효과를 위해 프레임이 활성화되어야 합니다. |
| frame_text_color | String | #FFFFFF | 프레임 텍스트 색상입니다. 텍스트가 있는 프레임을 활성화해야 효과가 있습니다. |
예제 색상 QR 코드
| URL | https://api.genqrcode.com/public/generate |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY |
| 본문 | {
"type": 0,
"text": "https://genqrcode.com",
"color": "#ff0000",
"background_color": "#aaffaa",
"inner_eye_color": "#ffaaaa",
"outer_eye_color": "#ffaaff"
} |
| 응답 |  |
예제 색상 패턴 QR 코드
| URL | https://api.genqrcode.com/public/generate |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY |
| 본문 | {
"type": 0,
"text": "https://genqrcode.com",
"color": "#e81416,#faeb36,#79c314,#487de7,#4b369d,#70369d",
"custom_color_pattern": "1,1,2,2,3,3,4,4,5,5,6,6"
} |
| 응답 |  |
프레임, 모양 및 로고 매개변수
사용자 지정 가능한 프레임, 모양 및 로고 매개변수와 사용 방법을 설명합니다.
| 매개변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
| style | Int | 0 |
QR 코드 정사각형의 스타일.
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
| inner_eye_style | Int | 0 |
QR 코드 내부 눈의 스타일.
0
1
2
3
4
5
6
7
|
| outer_eye_style | Int | 0 |
QR 코드 외부 눈의 스타일.
0
1
2
3
4
5
6
|
| frame_style | Int | 0 |
QR 코드 주위 프레임의 스타일.
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
| frame_text | String | SCAN ME | 프레임 내부의 텍스트입니다. 텍스트가 있는 프레임을 설정해야 표시됩니다. |
| logo | String |
QR 코드 내부에 사용할 로고.
youtube
wifi
google-maps
facebook
spotify
threads
zoom
instagram
linkedin
genqrcode
google-drive
airbnb
skype
snapchat
twitter
x-twitter
reddit
|
|
| logo_remove_background | Boolean | false | 로고 뒤의 배경을 제거할지 여부. |
예제 로고 및 모양 QR 코드
| URL | https://api.genqrcode.com/public/generate |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY |
| 본문 | {
"type": 0,
"text": "https://x.com/genqrcode",
"style": 22,
"inner_eye_style": 1,
"outer_eye_style": 4,
"frame": 10,
"frame_text": "My X Page",
"logo": "x-twitter",
"logo_remove_background":true
} |
| 응답 |  |
예제 사용자 지정 로고
사용자 지정 로고를 사용하려면 멀티파트 폼 데이터 요청을 사용하여 로고를 업로드해야 합니다. 업로드된 로고는 로고 필드에서 사용할 수 있습니다.
| URL | https://api.genqrcode.com/public/upload/logo |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY Content-Type: multipart/form-data |
| 응답 | 586d0136af8a06e4a2b50cf9f2af0b72 |
빠른 QR 코드 API
빠른 QR 코드 API는 일반 API의 1/50 토큰만 소비합니다. QR 코드는 속도 및 다운로드 크기 최적화가 이루어집니다. 모든 QR 코드 유형을 지원하지만, 일부 사용자 지정 매개변수만 사용할 수 있습니다.
빠른 QR 코드 매개변수
사용 가능한 모든 빠른 QR 코드 매개변수와 사용 방법을 설명합니다.
| 매개변수 | 유형 | 기본값 | 설명 | ||||
|---|---|---|---|---|---|---|---|
| imageformat | String | png |
QR 코드의 이미지 형식입니다.
가능한 값
|
||||
| bordersize | Int | 4 | QR 코드 주위의 테두리 크기. | ||||
| width | Int | 500 | QR 코드의 너비. 자동으로 가장 가까운 설정된 크기로 조정되어 크기 조정으로 인한 아티팩트를 방지합니다. 최대 크기 4000. | ||||
| height | Int | 500 | QR 코드의 높이. 자동으로 가장 가까운 설정된 크기로 조정되어 크기 조정으로 인한 아티팩트를 방지합니다. 최대 크기 4000. |
예제 빠른 텍스트 QR 코드
| URL | https://api.genqrcode.com/public/fastgenerate |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY |
| 본문 | {
"imageformat": "png",
"type": 0,
"text": "https://genqrcode.com"
} |
| 응답 | |
빠른 배치 QR 코드 API
예제 빠른 배치 텍스트 QR 코드
| URL | https://api.genqrcode.com/public/fastbatch |
|---|---|
| 요청 방법 | POST |
| 헤더 | GenQRCode-apikey: API_KEY |
| 본문 | {
"QR Code 1": {
"text": "https://genqrcode.com",
"type": 0,
"width": 500,
"bordersize": 4,
"imageformat": "png",
"height": 500
},
"QR Code 2": {
"text": "https://genqrcode.com/dynamicview",
"type": 0,
"width": 500,
"bordersize": 4,
"imageformat": "png",
"height": 500
},
"QR Code 3": {
"text": "https://genqrcode.com/pricing",
"type": 0,
"width": 500,
"bordersize": 4,
"imageformat": "png",
"height": 500
}
} |
| 응답 | QR Codes in a zip file. |