바코드와 리테일
PDF 문서와 라벨을 위한 PDF417 바코드 API
물류, 티켓, 탑승권 스타일, 문서 워크플로를 위해 PDF 안에 PDF417 바코드를 렌더링하되, 요청 데이터 규칙은 호출 시스템이 담당합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 물류 백엔드 / 티켓팅 백엔드 / 여행 워크플로 / 문서 자동화 서비스
해결할 작업
PDF417 바코드 요청 데이터를 라벨, 티켓, 양식 또는 탑승권 스타일 문서 안의 벡터 PDF 요소로 렌더링하되, 인코딩 형식과 후속 검증 책임은 호출 시스템이 유지합니다.
이 API를 쓰는 경우
- PDF 문서나 라벨 안에 PDF417 바코드를 삽입해야 합니다.
- 시스템에 최종 인코딩 데이터가 있고 후속 스캐너 요구사항을 알고 있습니다.
- Template Render를 통해 반복되는 PDF417 레이아웃이 필요합니다.
- 독립 바코드 이미지가 아니라 PDF 출력이 필요합니다.
대체하지 않는 것
- gPdf가 항공사, 정부, 물류 또는 업종별 데이터 형식을 인증해야 합니다.
- 티켓 재고, 좌석 배정 또는 여행 예약 로직이 필요합니다.
- 스캐너 하드웨어 관리가 필요합니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - 티켓 스타일 페이지의 PDF417 바코드.
{
"pages": [
{
"size": "a6",
"elements": [
{
"type": "text",
"x": 10,
"y": 14,
"content": "Boarding pass sample",
"style": { "font_size": 14, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "pdf417",
"content": "M1DOE/JOHN EABC123 JFKLAX GP 042 001A0001 100",
"x": 10,
"y": 38,
"width": 80,
"height": 28
}
]
}
]
}
gPdf가 처리하는 것
- PDF 출력 내부의 벡터 PDF417 바코드 렌더링.
- 바코드 주변의 문서 또는 라벨 레이아웃.
- 반복되는 티켓 또는 물류 레이아웃을 위한 템플릿 바인딩.
- 공개 Render API를 통한 바이너리 PDF 응답.
자체 시스템이 책임지는 것
- 인코딩된 PDF417 데이터, 업종 규칙, 티켓 또는 배송 상태, 고객 신원.
- 스캐너 승인, 물리적 인쇄 테스트, 부정 사용 방지.
- 바코드로 트리거되는 후속 예약, 접근 또는 물류 운영.
운영 전 체크리스트
- PDF417 데이터를 소비하는 스캐너 또는 파트너 시스템으로 검증합니다.
- 운영 크기와 소재로 인쇄 및 스캔합니다.
- 목적지 워크플로가 요구하지 않는 한 민감한 데이터를 바코드에 넣지 않습니다.
- 승인된 반복 레이아웃에는 Template Render를 사용합니다.
- 티켓, 배송 또는 문서 ID와 함께 요청 ID를 기록합니다.
지원 범위의 경계
- gPdf는 PDF417 바코드를 렌더링하며, 업종별 데이터 형식을 인증하지 않습니다.
- 티켓팅, 여행, 신원, 물류의 업무상 의미는 호출 시스템에 남아 있습니다.
- 물리적 스캔 검증은 여전히 필요합니다.
PDF417은 바코드이지 비즈니스 프로세스가 아닙니다
PDF417은 티켓, 여행, 신원, 물류 워크플로에 자주 등장합니다. gPdf는 PDF 안에 바코드를 렌더링할 수 있습니다. 데이터 형식, 신원 확인, 예약 상태, 후속 승인 절차는 render API 밖에 남아 있습니다.
FAQ
- gPdf가 PDF417을 지원하나요?
- 예. 공개 바코드 형식 enum에는 pdf417과 MicroPDF417 alias가 포함되어 있습니다.
- gPdf가 항공기 탑승권 데이터를 만들 수 있나요?
- 아니요. gPdf는 사용자가 보낸 PDF417 값을 렌더링합니다. 데이터 구성은 여행 또는 티켓팅 시스템의 책임입니다.
- PDF417을 Template Render와 함께 사용할 수 있나요?
- 예. 반복 레이아웃이 요청 데이터와 비즈니스 데이터만 받도록 해야 할 때 Template Render를 사용하세요.
- 결과를 스캔 테스트해야 하나요?
- 예. PDF417 워크플로는 소비하는 스캐너와 운영 인쇄 소재로 검증해야 합니다.