포장영상 API
기존 시스템에 그대로 붙입니다

핵심 엔드포인트

• POST/v1/recordings

  운송장 번호와 함께 포장영상 녹화 시작 요청. 바코드 스캐너 대신 시스템에서 직접 트리거할 때 사용.

• GET/v1/recordings/{trackingNo}

  운송장 번호로 포장영상 메타데이터(URL, 길이, 촬영 일시) 조회.

• GET/v1/recordings/{trackingNo}/share-link

  고객 공유용 포장영상 링크 생성 (만료 기간 설정 가능).

• POST/v1/webhooks

  포장영상 녹화 완료·업로드 완료 이벤트를 사용자 시스템으로 푸시.

예시 — 운송장으로 영상 조회

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.zeropacking.com/v1/recordings/1234567890

{
  "trackingNo": "1234567890",
  "recordedAt": "2026-05-10T14:23:11+09:00",
  "duration": 47,
  "url": "https://cdn.zeropacking.com/v/abc123",
  "shareLink": "https://zeropacking.com/v/abc123",
  "thumbnail": "https://cdn.zeropacking.com/t/abc123.jpg"
}

지원하는 시스템

• 카페24

  주문 발송 시 운송장 자동 매칭, 영상 링크 자동 메모 등록

• 고도몰 5

  주문관리 → 발송완료 시점 트리거로 영상 색인

• 메이크샵

  MS 표준 API로 운송장 등록 시 동기화

• 스마트스토어

  엑셀 일괄 발송 후 운송장 매핑 자동화

• 자체 WMS

  REST API + Webhook으로 어떤 시스템과도 연동

• ERP (더존, SAP 등)

  발송 완료 트리거를 ERP에 연결, 회계 마감과 연동

자주 묻는 질문