QR 코드 API
QR Code Crafter API는 에이전트, 내부 도구, 템플릿 시스템, 캠페인 운영, 문서 자동화에서 정적 QR 파일을 반복적으로 생성할 수 있도록 설계되어 있습니다.
단일 생성은 /.netlify/functions/generate-qr 엔드포인트를 GET 또는 POST로 호출합니다. 대량 생성은 /.netlify/functions/generate-qr-bulk에 CSV 또는 row 객체를 보내고 QR 파일과 manifest를 포함한 ZIP을 받습니다.
같은 요청 구조에서 SVG, PNG, JPG, WebP, PDF, EPS를 선택할 수 있어 웹 게시, 이메일, 문서, 인쇄, 포장, 디자인 도구까지 한 흐름으로 처리할 수 있습니다.
AI 에이전트는 /.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json, /ai.txt, /llms.txt를 통해 파라미터와 예시를 발견할 수 있습니다. 라이브 페이지에는 WebMCP 도구와 선언형 form 마크업도 노출됩니다.
OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.
이 API는 정적 QR 자산을 만듭니다. 스캔 대시보드나 인쇄 후 목적지 편집이 필요하면 동적 QR 또는 직접 관리하는 리디렉션을 별도 워크플로로 선택하고, 단순 캠페인 측정은 UTM 링크를 먼저 인코딩합니다.
가이드
단일 QR 생성 엔드포인트
GET 쿼리 파라미터 또는 POST JSON body로 하나의 QR 파일을 생성합니다. 긴 payload, vCard, 이벤트, 로고 data URL은 POST가 더 안정적입니다.
에이전트가 읽을 수 있는 발견 파일
OpenAPI, WebMCP, ai.txt, llms.txt를 제공해 브라우저 에이전트와 API 클라이언트가 요청 스키마를 추측하지 않고 사용할 수 있습니다.
6가지 내보내기 형식
SVG, PNG, JPG, WebP, PDF, EPS를 지원합니다. 인쇄와 디자인 전달에는 SVG, PDF, EPS를, 웹과 문서에는 PNG 또는 WebP를 우선 검토합니다.
대량 ZIP 생성
generate-qr-bulk는 최대 50개 행을 처리해 QR 파일, manifest.csv, manifest.json이 포함된 ZIP을 반환합니다.
검증 가능한 응답 메타데이터
POST 응답과 GET 헤더에서 content type, 확장자, byte length, width, height, unit을 확인해 저장 전 검증할 수 있습니다.
정적·프라이버시 우선 모델
필수 제공업체 리디렉션 없이 QR 패턴에 최종 payload를 저장합니다. 분석이 필요하면 먼저 UTM이 포함된 URL을 만든 뒤 QR로 인코딩합니다.
QR 코드 API 요청 옵션
| 옵션 | 지원 값 | 운영 시 확인할 점 |
|---|---|---|
| 단일 엔드포인트 | GET 또는 POST /.netlify/functions/generate-qr | 한 개의 URL, Wi-Fi, vCard, 이벤트, 결제, 텍스트 payload를 QR 파일로 생성합니다. |
| 대량 엔드포인트 | POST /.netlify/functions/generate-qr-bulk | CSV 또는 JSON rows를 보내 ZIP, manifest.csv, manifest.json을 받습니다. |
| 대량 제한 | 요청당 1-50개 행 | 브라우저 에이전트와 공개 자동화가 과도한 작업을 만들지 않도록 범위를 제한합니다. |
| format | svg, png, jpg, webp, pdf, eps | 채널에 맞는 산출물을 선택합니다. 대량 자동화는 SVG, 인쇄 전달은 PDF 또는 EPS가 관리하기 쉽습니다. |
| size | 256-4096 | 라스터 이미지와 문서 산출물의 크기를 정하고, 최종 사용 크기보다 작게 저장하지 않습니다. |
| 오류 정정 | L, M, Q, H | 로고를 넣거나 인쇄 조건이 까다로운 경우 H를 선택하고 최종 파일을 다시 스캔합니다. |
| 응답 검증 | contentType, extension, byteLength, width, height, unit | 저장, 업로드, ZIP 처리 전에 파일 형식과 크기가 요청과 일치하는지 확인합니다. |
| 발견 문서 | OpenAPI, WebMCP, ai.txt, llms.txt | AI 에이전트와 클라이언트가 엔드포인트, 필드, 예시, 제한을 현재 상태로 읽게 합니다. |
| 캠페인 측정 | UTM URL 또는 직접 관리하는 redirect 인코딩 | API는 정적 QR 파일을 만듭니다. 분석은 목적지 흐름에서 처리합니다. |
에이전트가 QR 코드 API를 호출하는 방식
API 사용 흐름은 작게 유지되어 있습니다. payload를 만들고, 형식을 고르고, 응답 메타데이터를 확인한 뒤 다음 워크플로에 넘깁니다.
자동화에는 POST를 우선 사용
POST JSON은 긴 URL, vCard, 이벤트, Wi-Fi 문자열, 결제 payload, 로고 data URL을 쿼리 문자열에 노출하지 않고 base64 데이터와 파일 메타데이터를 받을 수 있습니다.
직접 다운로드에는 GET 사용
GET 요청은 QR 파일을 바로 반환하고 X-QR-Width, X-QR-Height, X-QR-Unit, X-QR-Bytes 헤더로 크기와 byte length를 제공합니다.
WebMCP가 가능하면 도구로 등록
라이브 페이지는 지원 브라우저에서 generate_qr와 generate_bulk_qr 도구를 등록하고, 스캐너가 읽을 수 있는 toolname form도 제공합니다.
저장 전 파일 검증
contentType, extension, byteLength, dimensions를 확인한 뒤 SVG, PNG, JPG, WebP, PDF, EPS 파일을 스토리지나 CMS에 저장합니다.
대량 QR ZIP 생성 워크플로
라벨, 교실 자료, 제품 포장, 메뉴, 이벤트 배지, 캠페인 자산처럼 많은 정적 QR 파일이 필요할 때 bulk endpoint를 사용합니다.
CSV 또는 rows 객체 전송
filename,value CSV 또는 value와 filename을 가진 JSON 객체를 보냅니다. 빈 payload와 과도한 행은 생성 전에 거부해야 downstream 오류를 줄일 수 있습니다.
배치 단위 형식 선택
한 배치에는 하나의 export format을 사용합니다. 고용량 에이전트 작업은 SVG를 우선하고, 인쇄 전달에는 PDF 또는 EPS를 선택합니다.
ZIP 응답 요청
Accept: application/zip을 보내면 binary ZIP을 직접 받을 수 있습니다. JSON 응답은 base64 ZIP, byte length, file count, manifest 정보를 포함합니다.
manifest로 결과 대조
manifest.csv와 manifest.json을 읽어 원본 행, 생성 파일명, 상태, byte count를 대조한 뒤 실패 행만 재처리합니다.
API로 만들 수 있는 정적 QR payload
엔드포인트는 전달된 payload를 그대로 인코딩합니다. 먼저 스캐너가 읽어야 할 문자열을 정확히 만든 다음 필요한 파일 형식으로 생성합니다.
마케팅과 콘텐츠 링크
HTTPS URL, UTM 캠페인 링크, 앱 스토어 페이지, 소셜 프로필, 메뉴, PDF 랜딩 페이지, Google 리뷰 링크를 인코딩합니다.
기기 동작과 연락처
Wi-Fi 문자열, mailto, SMS, 전화 링크, WhatsApp 링크, 캘린더 이벤트, 지도 좌표, vCard 연락처 payload를 자동 생성할 수 있습니다.
결제와 지역별 payload
PIX EMV, UPI URI, crypto wallet URI처럼 결제 정보를 먼저 검증한 뒤 QR 파일을 생성합니다. 금액과 수취인은 별도 검수 절차를 둡니다.
인쇄와 디자인 산출물
생산용 artwork에는 SVG, PDF, EPS를 사용하고, 빠른 웹 게시와 미리보기에는 PNG, JPG, WebP를 사용합니다.
운영 안정성과 보안 경계
공개 API 자동화는 성공 응답만 확인해서 끝나지 않습니다. 속도 제한, 재시도, payload 안전성, 파일 보관, 추적 정책까지 함께 정해야 합니다.
Retry-After와 rate-limit 준수
429 또는 503 응답을 받으면 Retry-After와 X-RateLimit 헤더를 읽고 backoff합니다. 같은 요청을 빠르게 반복하면 대량 작업 신뢰성이 떨어집니다.
payload에 비밀값 금지
API key, 내부 토큰, 비공개 메모, 관리자 URL, 민감한 개인정보는 QR payload에 직접 넣지 않습니다. 공개되어도 되는 정보만 인코딩합니다.
UTM과 자체 분석 사용
정적 QR은 자체적으로 스캔 대시보드를 만들지 않습니다. 캠페인 성과가 필요하면 UTM이 포함된 URL이나 직접 관리하는 리디렉션을 payload로 사용합니다.
라이브 smoke test 유지
프로덕션 배포 후 대표 payload와 SVG, PNG, JPG, WebP, PDF, EPS 응답을 실제로 생성해 content type, 크기, 스캔 가능성을 확인합니다.
QR 코드 API 통합 체크리스트
- /ai.txt, /.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json을 먼저 읽어 현재 스키마와 예시를 확인한다.
- vCard, 이벤트, Wi-Fi, 결제, logo data URL처럼 길거나 특수문자가 많은 payload는 POST JSON을 사용한다.
- 단일 파일은 generate-qr, 대량 파일은 generate-qr-bulk를 사용하고 batch 크기는 50개 이하로 유지한다.
- 대량 다운로드가 필요하면 Accept: application/zip을 보내고 manifest.csv와 manifest.json을 저장한다.
- 자동화 클라이언트에는 식별 가능한 User-Agent를 설정한다.
- 429, 503, Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining 헤더를 처리한다.
- POST 응답의 base64 data를 디코딩하고 반환된 extension과 contentType에 맞게 저장한다.
- byteLength, width, height, unit, fileCount, manifest metadata가 요청 의도와 일치하는지 검증한다.
- URL 분석이 필요하면 QR 생성 전에 UTM 파라미터를 붙인다.
- 비밀 토큰, 내부 관리 링크, 민감한 개인정보를 QR payload에 직접 넣지 않는다.
- 인쇄용 파일은 SVG, PDF, EPS를 우선하고 최종 PDF 또는 실물 샘플을 다시 스캔한다.
- 프로덕션 사용 전 주요 content type과 모든 export format에 대한 라이브 smoke test를 실행한다.
가이드: 인쇄
정적 QR 코드를 자동으로 생성하는 QR 코드 API. 정적 QR 코드. 다운로드 SVG, PNG, JPG, WebP, PDF, EPS. 스캔. QR 인쇄 프리플라이트 체크리스트. 실시간 미리보기. 맞춤 설정 QR 코드. 계정 불필요. Keep the destination, owner, file name, publication channel, proof result, and review date with the campaign notes so printed and shared QR assets can be checked later.
정적 QR 코드를 자동으로 생성하는 QR 코드 API. URL QR 코드. 브라우저에서 생성. 인쇄. 디지털 사용. 접근성. QR 코드 안전과 개인정보 보호. QR 파일 형식. QR 코드 스캐너. Use the same checklist for websites, posters, packaging, receipts, menus, classroom handouts, payment notices, and customer support material.
URL QR 코드: HTTPS
정적 QR 코드를 자동으로 생성하는 QR 코드 API: URL QR 코드, 브라우저에서 생성, HTTPS, 스캔. 정적 QR 코드. 분석용 링크. UTM. QR 코드 안전과 개인정보 보호.
형식 선택
인쇄: SVG, PDF, EPS. 디지털 사용: PNG, JPG, WebP, SVG. QR 파일 형식. 다운로드. 벡터 내보내기. 형식 선택.
스캔
스캔. 실시간 미리보기. QR 코드 스캐너. QR 인쇄 프리플라이트 체크리스트. 인쇄. 디지털 사용. 맞춤 설정. Test the generator preview, downloaded file, placed artwork, CMS upload, exported PDF, and one physical proof before approving production.
회사
정적 QR 코드를 자동으로 생성하는 QR 코드 API: URL QR 코드, 다운로드, SVG, PNG, JPG, WebP, PDF, EPS, 인쇄, 디지털 사용, 스캔. 회사. 가이드. 피드백.
QR 코드 API
QR 코드 API. OpenAPI. WebMCP. ai.txt. llms.txt. 대량 QR 워크플로. 다운로드 SVG, PNG, JPG, WebP, PDF, EPS. 정적 QR 코드.
정적 QR과 동적 QR
정적 QR 코드를 자동으로 생성하는 QR 코드 API. 정적 QR 코드. 스캔 제한 없음. URL QR 코드. 분석용 링크. QR 코드 안전과 개인정보 보호. 브라우저에서 생성. 스캔.
피드백
URL QR 코드. 전화 QR 코드. 이메일 QR 코드. 접근성. 스캔. 피드백. SMS QR 코드.
접근성
접근성. 스캔. 인쇄. 디지털 사용. URL QR 코드. 브라우저에서 생성. 실시간 미리보기.
API로 QR 코드 생성하기
- 1
단일 또는 대량 생성을 선택
하나의 자산은 generate-qr를 사용하고, 여러 정적 QR 파일을 ZIP으로 받아야 하면 generate-qr-bulk를 사용합니다.
- 2
최종 payload 준비
URL, Wi-Fi 문자열, vCard, 이벤트, 결제 URI, 텍스트, CSV 또는 row 객체를 스캐너가 읽어야 하는 최종 형태로 만듭니다.
- 3
출력 형식 선택
인쇄와 디자인에는 SVG, PDF, EPS를, 웹 게시와 문서 미리보기에는 PNG, JPG, WebP를 선택합니다.
- 4
응답 검증
success, content type, extension, byte length, dimensions, manifest를 확인한 뒤 파일을 저장하거나 다음 시스템에 넘깁니다.
- 5
재시도와 모니터링 적용
Rate-limit 헤더와 Retry-After를 처리하고, 실패 row와 생성된 파일 수를 로그로 남겨 자동화가 조용히 실패하지 않게 합니다.
자주 묻는 질문
QR Code Crafter API 엔드포인트는 무엇인가요?
단일 QR 코드는 /.netlify/functions/generate-qr를 GET 또는 POST로 호출합니다. 최대 50개 파일의 ZIP이 필요하면 /.netlify/functions/generate-qr-bulk에 POST JSON 또는 CSV rows를 보냅니다.
API로 QR 코드를 대량 생성할 수 있나요?
예. generate-qr-bulk는 CSV 또는 row 객체를 받아 ZIP을 생성합니다. ZIP에는 QR 파일과 함께 manifest.csv, manifest.json이 포함되어 생성 결과를 대조할 수 있습니다.
이것은 QR code generator API인가요?
예. 정적 파일용 QR code generator API입니다. payload를 보내면 SVG, PNG, JPG, WebP, PDF, EPS QR 코드를 생성할 수 있습니다. API QR code generator, qrcode API, QR API, generate QR code API를 찾는 팀은 같은 공개 endpoint를 사용할 수 있습니다.
QR 코드 API를 무료로 사용할 수 있나요?
공개 생성은 계정 없이 사용할 수 있습니다. 발급된 키가 있는 환경에서는 X-Agent-Api-Key를 포함할 수 있으며, 클라이언트는 401 응답도 처리해야 합니다.
API는 어떤 파일 형식을 반환하나요?
SVG, PNG, JPG, WebP, PDF, EPS를 지원합니다. 자동화와 대량 처리에는 SVG가 가볍고, 인쇄 전달에는 PDF 또는 EPS가 적합합니다.
브라우저 에이전트가 WebMCP로 QR 코드를 만들 수 있나요?
지원 브라우저에서는 라이브 페이지가 generate_qr와 generate_bulk_qr 도구를 등록합니다. 또한 toolname 속성이 있는 선언형 form 마크업도 제공해 스캐너가 도구를 찾을 수 있습니다.
API가 동적 추적 QR 코드를 만들나요?
아니요. 이 API는 정적 QR 자산을 만듭니다. 캠페인 측정이 필요하면 UTM이 포함된 URL이나 직접 관리하는 리디렉션 URL을 먼저 만든 뒤 QR로 인코딩합니다.
대량 자동화에서 rate limit은 어떻게 처리하나요?
429 또는 503 응답이 오면 Retry-After와 X-RateLimit 헤더를 읽고 backoff합니다. 같은 payload를 즉시 반복 요청하지 말고 실패 row만 재처리하세요.
에이전트는 생성된 QR 파일을 어떻게 검증해야 하나요?
응답의 contentType, extension, byteLength, width, height, unit을 확인하고, 대량 ZIP에서는 manifest의 파일 수와 상태를 원본 row와 비교합니다.
QR payload에 넣으면 안 되는 정보가 있나요?
API key, 접근 토큰, 내부 관리자 URL, 비공개 메모, 민감한 개인정보는 공개 QR payload에 직접 넣지 않습니다. QR은 스캔 가능한 공개 자산으로 취급해야 합니다.
프로덕션 적용 전에 어떤 테스트가 필요한가요?
대표 payload와 모든 export format을 실제 엔드포인트에서 생성하고, 파일 형식, 크기, manifest, 스캔 가능성을 확인하는 라이브 smoke test가 필요합니다.