API 문서

REST API로 제품에서 QR 코드와 바코드를 만드세요. /api/v1에 JSON을 보내면 호스팅된 SVG 이미지를 받고, 같은 리소스를 나열하거나 업데이트할 수 있습니다.

QR 코드 만들기

type, 콘텐츠, 선택 디자인(색상, 모듈 스타일, 로고, 아이, 프레임)과 함께 POST /api/v1/qr-codes를 보냅니다. 응답에는 호스팅된 SVG URL이 포함됩니다.

{
  "name": "Website QR",
  "type": "url",
  "url": "https://forqrcode.com",
  "style": "rounded",
  "size": 500,
  "ecc": "M",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "qr_code_logo": "https://forqrcode.com/logo.png",
  "qr_code_logo_size": 25
}
QR 생성 레퍼런스

바코드 만들기

심볼로지, value, 선택 색상 또는 크기와 함께 POST /api/v1/barcodes를 보냅니다. Code 128부터 EAN-13까지 34가지 유형이 있습니다.

{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}
바코드 생성 레퍼런스

인증

모든 요청에 API 키를 Bearer 토큰으로 보내세요. 대시보드 → 계정 → API에서 확인하거나 재생성할 수 있습니다.

Authorization: Bearer YOUR_API_KEY

기본 URL: https://forqrcode.com/api/v1

속도 제한

API 키당 분당 60회 요청으로 제한됩니다. 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 헤더가 포함됩니다.

오류

오류는 JSON:API 형식을 사용합니다:

{ "errors": [{ "title": "…", "status": "422" }] }

유효성 검사 오류에 source.pointer가 포함될 수 있습니다.