QR 코드 생성기 API

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

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

기본 사용법

Linkly 짧은 링크에 .qr.png를 추가합니다:

https://your-domain.com/ABC123.qr.png

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

예시

HTML 페이지에 QR 코드를 삽입합니다:

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

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

스타일 매개변수

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

https://your-domain.com/ABC123.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`

참고: hex 색상은 URL 인코딩이 필요합니다 — # 대신 %23을 사용하세요(예: #ff0000은 %23ff0000).

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

링크 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"
  }
}

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

스타일 적용 방법

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

1기본 스타일 — 투명 배경에 검은 전경, 정사각형 모듈, 1024px
2저장된 스타일 — QR 코드 편집기에서 수행한 사용자 지정이나 링크 API를 통해 설정한 것이 링크에 저장됩니다
3쿼리 매개변수 재정의 — URL 매개변수를 통해 요청별로 개별 스타일을 재정의

로고가 있는 경우 Linkly는 자동으로 **높은 오류 정정(레벨 H)**을 사용하여 QR 코드가 스캔 가능하도록 보장합니다.

속도 제한

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

응답

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

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

{"error": "Rate limit exceeded"}