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

속도 제한

엔드포인트는 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 - 클릭 데이터 및 트래픽 보고서 내보내기