API 문서

대량 작업

대량 QR 코드 생성

API를 사용하여 QR 코드 생성을 자동화합니다. 한 번에 수백 개 또는 수천 개의 QR 코드를 생성할 수 있으며, 대규모 캠페인, 제품 라벨링 또는 자산 추적에 적합합니다.

CSV 가져오기

QR 코드 데이터가 포함된 CSV 파일을 업로드하면 모든 QR 코드를 한 번에 생성합니다.

API 배치

JSON 페이로드로 단일 API 호출에서 여러 QR 코드를 생성합니다.

비동기 처리

대량 가져오기는 백그라운드에서 실행되며 상태 추적이 가능합니다.

엔드포인트

메서드	엔드포인트	설명
POST	/organizations/:orgId/qr-codes/bulk-import	CSV에서 대량 가져오기 시작
GET	/organizations/:orgId/qr-codes/bulk-import	모든 가져오기 작업 목록
GET	/organizations/:orgId/qr-codes/bulk-import/:id	가져오기 작업 상태 가져오기
GET	/organizations/:orgId/qr-codes/bulk-import/sample	CSV 템플릿 다운로드
POST	/organizations/:orgId/qr-codes/batch/update	여러 QR 코드 일괄 업데이트
POST	/organizations/:orgId/qr-codes/batch/clone	여러 QR 코드 복제
DELETE	/organizations/:orgId/qr-codes/batch	여러 QR 코드 삭제

CSV 대량 가져오기

한 번에 많은 QR 코드를 생성하는 가장 쉬운 방법은 CSV 가져오기입니다. 다음 단계를 따르세요:

CSV 템플릿 다운로드

올바른 형식을 보장하기 위해 QR 코드 유형에 대한 템플릿을 가져옵니다.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv

데이터 입력

QR 코드 데이터를 CSV 파일에 추가합니다. URL QR 코드에 대한 예는 다음과 같습니다:

url_qr_codes.csv

name,url,folder,tags
Homepage QR,https://example.com,Marketing,homepage;main
Product Page,https://example.com/product,Products,product;featured
Contact Us,https://example.com/contact,Marketing,contact;support
Promo Landing,https://example.com/promo,Campaigns,promo;summer2024

CSV 파일 업로드

가져오기 작업을 시작하기 위해 파일을 전송합니다.

가져오기 시작

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@url_qr_codes.csv" \
  -F "type=URL"

가져오기 진행 상황 모니터링

가져오기 작업의 상태를 확인합니다.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/import_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

응답

{
  "id": "import_abc123",
  "status": "COMPLETED",
  "type": "URL",
  "totalRows": 100,
  "processedRows": 100,
  "successCount": 98,
  "errorCount": 2,
  "errors": [
    { "row": 45, "error": "Invalid URL format" },
    { "row": 72, "error": "Name is required" }
  ],
  "createdAt": "2024-01-15T10:00:00Z",
  "completedAt": "2024-01-15T10:02:30Z"
}

CSV 열 참조

각 QR 코드 유형은 서로 다른 열이 필요합니다. 가장 일반적인 열은 다음과 같습니다:

URL QR 코드

열	필수	설명
name	필수	QR 코드의 표시 이름
url	필수	대상 URL (http:// 또는 https://로 시작해야 함)
folder	선택	QR 코드를 정리할 폴더 이름
tags	선택	세미콜론으로 구분된 태그

vCard QR 코드

열	필수	설명
name	필수	QR 코드의 표시 이름
firstName	필수	연락처의 이름
lastName	필수	연락처의 성
email	선택	이메일 주소
phone	선택	전화번호
company	선택	회사 이름
title	선택	직책

배치 업데이트

단일 API 호출로 여러 QR 코드를 한 번에 업데이트합니다.

POST

/organizations/:orgId/qr-codes/batch/update

배치 업데이트 요청

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/batch/update" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["qr_abc123", "qr_def456", "qr_ghi789"],
    "updates": {
      "folderId": "folder_xyz",
      "style": {
        "foregroundColor": "#1D59F9"
      }
    }
  }'

가져오기 한도

최대 행 수

10,000

CSV 파일당 QR 코드 수

파일 크기 제한

10 MB

최대 CSV 파일 크기

팁: 매우 큰 가져오기(10,000개 이상의 QR 코드)의 경우, CSV를 여러 파일로 나누고 순차적으로 가져오는 것을 고려하세요.

사용 사례

제품 라벨링

재고의 모든 제품에 대해 고유한 QR 코드를 생성합니다.

마케팅 캠페인

각 수신자에게 개인화된 QR 코드를 생성합니다.

자산 추적

장비, 문서 또는 물리적 자산에 라벨을 붙입니다.

이벤트 관리

고유한 QR 코드로 티켓이나 배지를 생성합니다.

다음 단계

관련 기능에 대해 알아보세요: