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://your-domain.com/ABC123.qr.png

이 명령은 1024x1024 PNG 이미지 형식의 QR 코드를 반환합니다. Linkly에서 QR 코드의 색상, 스타일 또는 로고를 사용자 정의했다면 이러한 스타일이 자동으로 적용됩니다.

예제

HTML 페이지에 QR 코드 삽입:

<img src="https://your-domain.com/ABC123.qr.png" alt="QR Code" />

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

스타일 매개변수

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

https://your-domain.com/ABC123.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픽셀 너비의 흰색 테두리를 추가합니다.

링크 API를 통해 스타일 설정

링크 단축 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 코드 편집기에서 만들거나 링크 API를 통해 설정한 모든 사용자 정의가 링크와 함께 저장됩니다
3쿼리 매개변수 재정의 — URL 매개변수를 통해 요청당 개별 스타일을 재정의합니다

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

속도 제한

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

응답

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

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

{"error": "Rate limit exceeded"}