명찰, 테이블 카드, 진열대 라벨, 상품 태그에는 각각 고유한 QR 코드가 필요하고, 수백 개를 손으로 만드는 것은 불가능에 가깝습니다. Posty5의 대량 가져오기는 CSV 파일 하나를 QR 코드로 바꾸고, 무엇이든 생성하기 전에 모든 행을 검사한 뒤, 행마다 PNG 이미지 하나씩을 인쇄에 필요한 이름으로 담은 ZIP 하나를 만들어 줍니다.
- Bulk import 열기 — Posty5 대시보드에서 QR Code Generator를 열고 Bulk import를 선택합니다.
- 템플릿 채우기 — CSV 템플릿을 내려받아 QR 코드마다 한 행씩 채우고, fileName에는 각 이미지에 필요한 이름을 넣습니다.
- 업로드 및 검사 — 파일을 업로드하고 기본 템플릿과 이미지 크기를 고른 뒤 검사합니다. Posty5는 무엇이든 생성하기 전에 오류가 있는 행을 모두 보여 줍니다.
- 코드 생성 — 가져오기를 시작하고 진행 상황을 확인하거나, 페이지를 떠나 알림을 기다립니다.
- ZIP 내려받기 — PNG 이미지 ZIP과 결과 파일을 내려받습니다.
시작하기 전에
로그인된 Posty5 계정이 필요합니다. 대시보드에서 QR Code Generator를 열고 Bulk import를 선택하세요. 대량 생성 사용 여부는 요금제에 따라 다르며, 요금제에 포함되어 있지 않으면 페이지에 잠김으로 표시됩니다.
페이지에서 제공하는 CSV 템플릿으로 시작하세요. 헤더 행과 예시 행 하나가 들어 있습니다.
CSV 파일 만들기
모든 행에 다음 열을 넣을 수 있습니다. 열 이름은 대소문자를 구분하지 않습니다.
type | 코드에 담을 내용의 종류입니다. 비워 두면 url이 됩니다. |
name | 내 목록에서 쓸 이름입니다. |
customId | 요금제에서 사용자 지정 끝부분을 허용하는 경우, 코드 링크의 끝부분을 직접 정합니다. 앞선 행을 포함해 아직 사용되지 않은 값이어야 합니다. |
tag | 나중에 코드를 묶고 필터링하기 위한 태그입니다. |
refId | 상품 코드나 참가자 코드 같은 자체 참조값입니다. |
templateId | 이 행의 디자인 템플릿입니다. 고른 기본값보다 우선합니다. |
fileName | ZIP 안에서 쓸 이미지 이름입니다. 비워 두면 코드의 이름이 사용됩니다. |
그다음 행의 종류에 맞는 열을 추가하세요.
url | url |
freeText | text |
email | email, subject, body |
wifi | ssid, security, password |
call | phoneNumber |
sms | phoneNumber, message |
geolocation | latitude, longitude, mapUrl |
파일은 쉼표로 구분하고 헤더 행이 있는 UTF-8 CSV로 저장하세요. 파일 유형 QR 코드는 파일마다 따로 업로드해야 하므로 대량으로 만들 수 없습니다.
QR 대량 가져오기 시작하기업로드, 이미지 크기 선택, 검사
업로드한 뒤 기본 템플릿, 태그, 참조 ID와 이미지 크기(512, 1,024 또는 2,000픽셀)를 고르세요. 이미지는 PNG입니다. 그런 다음 파일을 검사합니다. Posty5는 아무것도 생성하지 않고 모든 행을 읽은 뒤, 오류가 있는 행을 행 번호와 이유와 함께 보여 줍니다. 이유는 행의 종류에 필요한 값이 없거나 올바르지 않은 경우, 값이 너무 긴 경우, 사용자 지정 끝부분이 이미 쓰였거나 요금제에서 허용되지 않는 경우, 템플릿이 내 것이 아닌 경우 등입니다.
코드 생성하기
가져오기를 시작하세요. 작업은 백그라운드에서 진행되며 처리된 행, 생성된 행, 실패한 행의 수가 표시됩니다. 페이지를 떠나도 끝나면 알림으로 알려 드립니다.
진행 중인 가져오기는 취소할 수 있습니다. 취소 전에 만들어진 코드는 계정에 그대로 남습니다.
- 파일 하나에는 최대 5,000행, 2 MB까지 담을 수 있습니다.
- 대량 생성은 계정당 하루(UTC) 최대 20,000행까지 가능하며, 모든 가져오기와 API 호출을 합산합니다.
- 가져오기는 한 번에 하나씩 실행되며, 그 뒤에 최대 세 개까지 대기할 수 있습니다.
- 계정의 크레딧이 떨어지면 해당 행과 그 이후의 모든 행이 실패하며, 이미 만들어진 코드는 그대로 남습니다.
ZIP과 결과 내려받기
가져오기가 끝나면 이미지 ZIP, 결과 파일(행마다 한 줄씩 상태와 새 코드의 세부 정보 포함), 그리고 실패한 행이 있다면 그 행들을 작성한 그대로 담은 오류 파일을 내려받으세요.
이미지 이름은 어떤 시스템에서도 안전하게 쓸 수 있도록 다듬어지고 100자로 줄어듭니다. 이름이 같은 행이 둘이면 -2, -3 등이 붙고, 쓸 수 있는 문자가 없는 이름은 qr- 뒤에 행 번호를 붙인 이름이 됩니다.
다운로드 링크는 15분 동안 유효합니다. 새 링크가 필요하면 지난 가져오기 목록에서 해당 가져오기를 다시 여세요. 업로드한 파일과 결과 파일은 7일 동안, 가져오기 기록은 30일 동안 보관됩니다.
가져오기 이후의 코드
모든 행은 QR 코드 목록의 일반 QR 코드가 됩니다. 직접 만든 코드처럼 열어서 편집하고 다시 내려받을 수 있습니다.
QR 코드 목록에서 Export CSV와 Export JSON으로 목록의 필터를 반영해 파일당 최대 50,000행까지 코드를 내려받을 수 있습니다. Wi-Fi 비밀번호는 내보내기에 절대 포함되지 않습니다.
정적 QR 코드는 내용을 직접 담고 있어 스캔해도 Posty5를 거치지 않으므로 스캔 수가 집계되지 않습니다. 스캔을 집계할 수 있는 것은 Posty5 주소를 가리키는 코드뿐입니다.
코드로 처리하기
개발자는 API 키로 같은 CSV 또는 JSON 행을 Posty5 API(POST /api/link-bulk-jobs)를 통해 작업으로 제출하고, ZIP이 준비될 때까지 폴링할 수 있습니다. 같은 검사와 한도가 적용됩니다. 각 경로는 API 레퍼런스에 문서화되어 있습니다.
자주 묻는 질문
한 번에 몇 개의 QR 코드를 생성할 수 있나요?
파일 하나에 최대 5,000행, 2 MB까지 담을 수 있고, 대량 생성은 계정당 하루 최대 20,000행까지 가능합니다.
대량 생성이 가능한 QR 유형은 무엇인가요?
URL, 자유 텍스트, 이메일, Wi-Fi, 전화, SMS, 위치 정보입니다. 파일 유형 코드는 대량으로 만들 수 없습니다.
대량으로 만든 QR 코드를 편집할 수 있나요?
네. 모든 행은 목록의 일반 QR 코드가 되어 열고, 편집하고, 다시 내려받을 수 있습니다.
이 코드들의 스캔 수를 볼 수 있나요?
Posty5 주소를 가리키는 코드만 볼 수 있습니다. 정적 코드는 내용을 직접 담고 있어 스캔이 Posty5에 전달되지 않습니다.
ZIP은 언제까지 받을 수 있나요?
각 다운로드 링크는 15분 동안 유효하고 파일은 7일 동안 보관됩니다. 새 링크가 필요하면 가져오기를 다시 여세요.
