QR 코드 생성기 API

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

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

기본 사용법

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

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

1024x1024 PNG 이미지로 QR 코드를 반환합니다. 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

참고: 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. 1
   기본 스타일 — 투명한 배경의 검은색 전경, 정사각형 모듈, 1024px
2. 2
   저장된 스타일 — QR 코드 편집기에서 만들었거나 링크 API를 통해 설정한 사용자 지정 사항이 링크와 함께 저장됩니다
3. 3
   쿼리 매개변수 재정의 — URL 매개변수를 통해 요청별로 개별 스타일을 재정의합니다

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

속도 제한

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

응답

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

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

{"error": "Rate limit exceeded"}

관련 리소스

• QR 코드 생성 - Linkly에서 QR 코드를 생성하고 사용자 지정하는 방법
• QR 코드에 로고 추가 - 회사 로고를 포함한 브랜드 QR 코드 생성
• SVG QR 코드 - 확장 가능한 벡터 형식으로 QR 코드 다운로드
• 링크 단축 API - 프로그래밍 방식으로 링크 생성 및 관리
• 분석 API - 클릭 데이터 및 트래픽 보고서 내보내기