QR 코드 생성기 API

모든 Linkly 짧은 링크에 .qr.png을 추가하여 QR 코드 이미지를 생성합니다. 인증 또는 API 키가 필요하지 않습니다.

이미지는 커스텀 색상, 점 패턴, 아이 스타일, 로고를 포함한 모든 저장된 QR 코드 스타일이 적용된 PNG로 반환됩니다.

Add .qr.png to any Linkly link to get the QR code, served as a PNG

기본 사용법

모든 Linkly 짧은 링크에 .qr.png을 추가합니다:

https://linkly.link/2W6Z9.qr.png

이는 QR 코드의 1024x1024 PNG 이미지를 반환합니다. Linkly에서 QR 코드의 색상, 스타일 또는 로고를 사용자 정의한 경우, 해당 스타일이 자동으로 적용됩니다.

예제

HTML 페이지에 QR 코드 삽입:

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

또는 이메일 템플릿, PDF 또는 이미지 URL을 지원하는 모든 시스템에서 사용합니다.

스타일 매개변수

쿼리 매개변수를 전달하여 링크의 저장된 QR 스타일을 재정의하거나 이미지 크기를 변경합니다:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

매개변수	설명	예제
size	이미지 크기(픽셀 단위, 100–2048)	`1024`
fgColor	전경색(hex, URL 인코딩됨)	`%23009eff`
bgColor	배경색(hex, URL 인코딩됨)	`%23ffffff`
qrStyle	모듈 스타일	`squares`, `dots`, 또는 `fluid`
eyeStyle	아이 패턴 스타일	`square` 또는 `rounded`
eyeColorInner	내부 아이 색상(hex)	`%23ff0000`
eyeColorOuter	외부 아이 색상(hex)	`%230000ff`
logoImage	로고 이미지의 URL	`https://example.com/logo.png`
logoWidth	로고 너비(픽셀 단위)	`60`
logoHeight	로고 높이(픽셀 단위)	`60`
logoPadding	로고 주변 여백(픽셀 단위)	`10`
logoStyle	로고 여백 모양	`square` 또는 `circle`
quietZone	QR 코드 주변 여백(픽셀 단위, 0–200)	`50`

참고: hex 색상은 URL 인코딩되어야 하므로 # 대신 %23을 사용합니다(예: #ff0000의 경우 %23ff0000).

로고 크기는 요청한 이미지 크기에 맞게 자동으로 조정됩니다.

quietZone은 전체 QR 코드 주변에 bgColor로 채워진 공백 여백을 추가합니다. 이는 QR 코드를 어두운 배경에 인쇄할 때 유용합니다. 없으면 위치 지정 아이가 가장자리에 바짝 붙어 신뢰할 수 없게 스캔될 수 있습니다. 예를 들어, quietZone=50&bgColor=%23ffffff는 50픽셀의 흰색 테두리를 추가합니다.

링크 API를 통해 스타일 설정

Link Shortening API를 통해 링크를 생성하거나 업데이트할 때 QR 코드 스타일을 링크에 저장할 수 있습니다. 위에 나열된 스타일 키 중 아무거나 포함하는 qr_styles JSON 객체를 전달합니다:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

저장된 후, 이러한 스타일은 .qr.png 이미지를 요청할 때마다 자동으로 적용됩니다. 쿼리 매개변수가 필요하지 않습니다.

스타일이 적용되는 방식

QR 코드 스타일은 다음 순서대로 해결됩니다:

1기본 스타일 — 투명한 배경의 검은 전경, 정사각형 모듈, 1024px
2저장된 스타일 — QR 코드 편집기에서 수행한 커스터마이징 또는 Link API를 통해 설정한 모든 것이 링크와 함께 저장됩니다
3쿼리 매개변수 재정의 — URL 매개변수를 통해 요청당 개별 스타일을 재정의합니다

로고가 있을 때, Linkly는 자동으로 **높은 오류 수정(Level H)**을 사용하여 QR 코드가 스캔 가능한 상태로 유지되도록 합니다.

속도 제한

끝점은 IP 주소당 초당 5개 요청으로 속도 제한됩니다. 이미지는 5분 동안 캐시되므로, 동일한 QR 코드에 대한 반복 요청이 빠르게 제공됩니다.

응답

성공한 요청은 200 상태와 Content-Type: image/png 및 응답 본문으로 PNG 이미지 데이터를 반환합니다.

오류 응답은 JSON을 반환합니다:

{"error": "Rate limit exceeded"}