QR 코드 생성기 API

Name: Linkly
Rating: 4.8 (38 reviews)
Author: Linkly

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

이미지는 PNG로 반환되며 모든 저장된 QR 코드 스타일(사용자 정의 색상, 도트 패턴, 눈 스타일, 로고 포함)이 적용됩니다.

모든 Linkly 링크에 .qr.png을 추가하여 QR 코드를 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	전경색 (16진수, URL 인코딩)	`%23009eff`
bgColor	배경색 (16진수, URL 인코딩)	`%23ffffff`
qrStyle	모듈 스타일	`squares`, `dots`, 또는 `fluid`
eyeStyle	눈 패턴 스타일	`square` 또는 `rounded`
eyeColorInner	내부 눈 색상 (16진수)	`%23ff0000`
eyeColorOuter	외부 눈 색상 (16진수)	`%230000ff`
logoImage	로고 이미지의 URL	`https://example.com/logo.png`
logoWidth	픽셀 단위 로고 너비	`60`
logoHeight	픽셀 단위 로고 높이	`60`
logoPadding	로고 주변 패딩 (픽셀)	`10`
logoStyle	로고 패딩 모양	`square` 또는 `circle`
quietZone	QR 코드 주변 패딩 (픽셀, 0–200)	`50`

참고: 16진수 색상은 URL 인코딩되어야 합니다. # 대신 %23을 사용하세요 (예: #ff0000은 %23ff0000).

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

quietZone은 QR 코드 전체 주변에 공백 패딩을 추가하며, bgColor로 채워집니다. 이는 어두운 배경에 QR 코드를 인쇄할 때 유용합니다. 이것이 없으면 위치 지정 눈이 가장자리에 바짝 붙어 스캔이 제대로 되지 않을 수 있습니다. 예를 들어, quietZone=50&bgColor=%23ffffff는 50픽셀의 흰색 테두리를 추가합니다.

Link 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는 QR 코드가 스캔 가능하도록 자동으로 **높은 오류 수정 (Level H)**을 사용합니다.

속도 제한

엔드포인트는 IP 주소당 초당 5개 요청으로 제한됩니다. 이미지는 5분 동안 캐시되므로 동일한 QR 코드에 대한 반복 요청은 빠르게 처리됩니다.

응답

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

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

{"error": "Rate limit exceeded"}