외부 시스템 연동외부 재고 API
이벤트 수량 라인
이벤트 하나의 수량을 SKU별로 조회합니다. EPC 값은 공개하지 않습니다.
Endpoint
| 항목 | 값 |
|---|---|
| Method | GET |
| Path | /v1/external/events/{eventId}/lines |
| 인증 | Authorization: Bearer <developer-key> |
| 응답 단위 | 이벤트의 SKU별 합계 |
eventId는 위치별 재고 이벤트의 items[].id입니다.
Query parameters
| Query | 타입 | 설명 |
|---|---|---|
limit | integer | 1~100, 기본 50 |
cursor | string | 이전 응답의 page.nextCursor |
요청
curl --fail-with-body \
"$API_BASE_URL/v1/external/events/$EVENT_ID/lines?limit=50" \
-H "Authorization: Bearer $SUPERFID_DEVELOPER_KEY" \
-H "Accept: application/json"응답
{
"eventId": "event-uuid",
"lineMode": "epc",
"items": [
{ "sku": { "id": "sku-uuid", "code": "STYLE-001-BLK-M", "name": "Black / M" }, "quantity": 12 },
{ "sku": null, "quantity": 2 }
],
"page": { "nextCursor": null }
}해석과 페이지 이동
lineMode: "sku_quantity"이면 같은 SKU의 수량 줄을 합산한 수량입니다.lineMode: "epc"이면 SKU별 매핑 태그 수입니다. 아직 SKU와 연결되지 않은 태그는sku: null인 한 줄로 묶입니다.- 원시 EPC는 보안상 반환하지 않습니다. 파트너, 원가·판매가, lot 정보도 포함하지 않습니다.
- 다음 페이지가 있으면
page.nextCursor를 같은eventId로 전달하세요. 커서는 이벤트에 묶여 있습니다. - 존재하지 않거나 다른 워크스페이스에 속한 이벤트는
404를 반환합니다.