Inventory
Flowbox Inventory 모듈. 복수 창고·SKU 단위 잔량을 P95 320ms 안에 동기화하고 WMS 이벤트를 멱등 처리합니다.
GET /v1/inventory → Developers
한 페이지에서 시작하는 통합.
Flowbox API 는 재고 관리·주문 통합·출고·실시간 추적을 단일 REST + Webhook 으로 묶는 물류 자동화 레이어입니다. 5분이면 첫 동기화, P95 320ms 응답.
API 엔드포인트
하나의 API, 여섯 개의 동사.
풀필먼트 운영의 모든 흐름 — 재고 관리, 주문 통합, 출고, 실시간 추적 — 을 동일한 REST 규약으로 호출합니다. 47개 택배·WMS 커넥터가 같은 스키마 뒤에 숨어 있습니다.
Orders
Flowbox Orders 모듈. 채널별 주문을 단일 큐로 모으고 상태 전이(접수→피킹→출고)를 표준화합니다.
POST /v1/orders →Shipments
Flowbox Shipping 라벨 발급과 출고 라우팅. 택배사·국제특송 47개 커넥터를 같은 페이로드로 호출합니다.
POST /v1/shipments →Tracking
실시간 추적 스트림. 차량·WMS·고객 이벤트를 하나의 타임라인으로 노출합니다.
GET /v1/tracking/{id} →Webhooks
주문·재고·출고 이벤트를 HTTPS 콜백으로 푸시. HMAC 서명과 24시간 지수 백오프 재시도를 보장합니다.
POST /v1/webhooks →Catalogs
SKU·번들·바코드 카탈로그 동기화. 채널 카탈로그와 마스터 SKU 를 양방향 매핑합니다.
PUT /v1/catalogs → Quickstart
5분이면 첫 동기화.
API 키를 발급하고 첫 재고 동기화를 호출하기까지 — 세 줄이면 됩니다. cURL · Node · Python SDK 모두 동일한 규약으로 풀필먼트 B2B SaaS 흐름에 붙습니다.
curl -X POST 'https://api.flowbox.io/v1/inventory/sync' \
-H 'Authorization: Bearer fbx_live_YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"warehouse_id": "wh_seoul_01",
"sku": "SKU-1138",
"quantity": 240
}' 200 OK · 동기화 완료
{
"success": true,
"data": {
"sync_id": "syn_01HXR4Z9A2QK",
"warehouse_id": "wh_seoul_01",
"sku": "SKU-1138",
"quantity": 240,
"synced_at": "2026-05-25T09:14:22.318Z",
"latency_ms": 287,
"connector": "flowbox-wms-v2"
}
} 자주 묻는 개발자 질문
인증은 어떻게 하나요?
모든 요청은 Authorization 헤더에 Bearer 토큰을 실어 보냅니다. 키는 `fbx_live_` / `fbx_test_` 두 환경으로 분리되며, 콘솔에서 IP 화이트리스트와 스코프(read/write)를 키 단위로 설정할 수 있습니다.
Rate limit 정책은요?
기본 600 req/min, 버스트 60 req/sec 입니다. 응답 헤더 `X-RateLimit-Remaining`·`Retry-After` 로 잔량을 노출하며, Scale 플랜은 토큰 버킷을 5배로 확장합니다.
Webhook 재시도는 어떻게 동작하나요?
2xx 이외의 응답은 24시간 동안 지수 백오프(1m → 4m → 16m → … 최대 2h)로 재시도합니다. 모든 이벤트는 HMAC-SHA256 서명과 `X-Flowbox-Event-Id` 멱등키를 포함합니다.
공식 SDK 는 어떤 언어를 지원하나요?
Node.js, Python, Go, Java 4개 언어 공식 SDK 를 GitHub 에 공개합니다. OpenAPI 3.1 스펙을 함께 배포하므로 Ruby·PHP·C# 은 자동 생성으로 손쉽게 붙일 수 있습니다.
Sandbox 환경이 있나요?
`fbx_test_` 키로 호출하면 격리된 Sandbox 로 라우팅됩니다. 가상 창고·가상 택배 커넥터가 활성화되어 실제 라벨 발급 없이 출고 시나리오를 끝까지 검증할 수 있습니다.
SLA 와 상태 페이지는 어디서 보나요?
Scale 플랜 기준 99.95% 가동률 SLA 를 제공하며, P95 320ms 응답을 분기별로 공개합니다. 실시간 상태는 status.flowbox.io 에서 컴포넌트별로 확인할 수 있습니다.