개발자 QR 코드 API 가이드

QR 코드 API를 사용하면 사용자가 프로그래밍 방식으로 고품질 QR 코드를 생성하거나 대량의 QR 코드를 빠르게 생성할 수 있습니다. 자동 결제, 앱 통합, 제품 라벨 생성 등 다양한 사용 사례에 적합한 간단하고 효율적인 방법을 제공합니다. 이 API는 크기, 색상, 모양, 테두리, 유형 등 다양한 사용자 지정 옵션을 지원합니다. 개발자는 HTTP 요청을 수행하고 API 키를 제공하여 인증하거나, 제공되는 라이브러리를 사용하여 애플리케이션에 통합할 수 있습니다.

API 키

계정의 API 키는 계정 페이지에서 생성할 수 있습니다. API 키는 요청 시 URL 매개변수로 포함할 수 있으며, 예를 들어: https://genqrcode.com/api/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 상태 코드가 반환되어 요청이 제한되었음을 나타냅니다.

여러 개의 계정을 사용하여 이러한 제한을 우회하는 것은 금지됩니다. 더 높은 한도가 필요한 경우, 가격 문의를 위해 당사에 연락해 주세요.

라이브러리

Java Library

정적 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 네트워크에서 사용되는 암호화 방식.

가능한 값

wep Wi-Fi 네트워크가 여전히 WEP 암호화를 사용하는 경우 이 값을 선택하세요.
nopass Wi-Fi 네트워크에 비밀번호가 없는 경우 이 값을 선택하세요.
wpa 기본값입니다. WPA 암호화를 사용할 경우 이 값을 선택하세요. 어떤 값을 선택해야 할지 모르면 이 값을 사용하세요.

SMS

매개변수 유형 선택 사항 설명
type Int false Use 2 For a SMS QR Code
text String false SMS 메시지 내용.
number String false SMS 수신자 전화번호.

Email

매개변수 유형 선택 사항 설명
type Int false Use 3 For a Email QR Code
email 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 이메일 주소.

Whatsapp

매개변수 유형 선택 사항 설명
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"
}
응답 Text QR Code example

예제 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"
}
응답 WiFi QR Code example

일반 매개변수

사용 가능한 모든 일반 매개변수와 사용 방법을 설명합니다.

매개변수 유형 기본값 설명
imageformat String png QR 코드의 이미지 형식입니다.

가능한 값

tiff TIFF 이미지 형식.
svg SVG 이미지 형식.
gif GIF 이미지 형식.
obj OBJ 이미지 형식. 전체 색상 지원.
png PNG 이미지 형식.
jpeg JPEG 이미지 형식. 투명도를 지원하지 않습니다.
eps EPS 이미지 형식.
stl STL 이미지 형식. 색상 지원 없음.
webp WEBP 이미지 형식.
3mf 3MF 이미지 형식.
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 코드 주위 프레임의 색상. 이 효과를 적용하려면 프레임이 활성화되어 있어야 합니다.

예제 색상 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"
}
응답 Color QR Code example

예제 색상 패턴 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"
}
응답 Color pattern QR Code example

프레임, 모양 및 로고 매개변수

사용자 지정 가능한 프레임, 모양 및 로고 매개변수와 사용 방법을 설명합니다.

매개변수 유형 기본값 설명
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
/> /> /> /> /> />SCAN ME
2
/> /> /> /> /> /> /> />SCAN ME
3
/> /> /> />SCAN ME
4
/> /> />SCAN ME
5
/>SCAN ME
6
/>SCAN ME
7
/> /> />
8
/> /> /> /> />
9
/> /> /> /> /> /> /> /> /> /> /> /> />
10
/> /> /> /> /> /> />SCAN ME
11
/> />SCAN ME
12
SCAN ME
13
SCAN ME
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
}
응답 Style and logo QR Code example

예제 사용자 지정 로고

사용자 지정 로고를 사용하려면 멀티파트 폼 데이터 요청을 사용하여 로고를 업로드해야 합니다. 업로드된 로고는 로고 필드에서 사용할 수 있습니다.

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 코드의 이미지 형식입니다.

가능한 값

svg SVG 이미지 형식.
png PNG 이미지 형식.
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"
}
응답 Text QR Code example

빠른 배치 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.