이벗 API v3 둘러보기

이벗(EBUT) API v3 는 4개의 이커머스 물류 서비스를 단일 게이트웨이 api.ebut.co.kr 으로 통합한 REST 인터페이스입니다. JWT / API Key 이중 인증(페이똑딱은 JWT 전용), 표준화된 응답 구조, 계정 단위 호출량 집계로 셀러 시스템·내부 앱 모두를 안정적으로 지원합니다.

4개 서비스

각 서비스의 OpenAPI 3.1 문서는 포털에서 바로 열람할 수 있습니다. 서비스별 endpoint 수와 사용 사례는 아래 카드를 참고하세요.

게이트웨이 구조

이벗 API 는 모든 요청을 단일 진입점 api.ebut.co.kr 으로 받고 각 서비스 서버로 라우팅합니다. 각 서비스 백엔드 서버에 직접 접근하는 것은 불가능합니다.

외부 클라이언트
     │
     ▼  HTTPS (TLS 1.2 / 1.3)
api.ebut.co.kr  (Nginx 게이트웨이)
     │
     ├── /v3/wms/      → 이벗WMS 서버
     ├── /v3/manager/  → 이벗매니저 서버
     ├── /v3/cam/      → 이벗캠 서버
     ├── /v3/pay/      → 페이똑딱 서버
     └── /v3/mcp/      → 이벗WMS 서버 (MCP 전용)

인증 방식

요청 형태에 따라 두 가지 인증 방식 중 하나를 사용합니다. 자세한 헤더 형식·발급 방법은 인증 가이드 를 참고하세요.

표준 응답 구조

모든 endpoint 는 일관된 JSON 응답을 반환합니다. success 플래그로 성공 여부를 먼저 판단한 뒤 data 또는 error 를 처리하세요.

성공 (단건)

HTTP 200
{
  "success": true,
  "data": { ... }
}

성공 (목록)

HTTP 200
{
  "success": true,
  "data": [ ... ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total": 150,
    "total_pages": 8,
    "has_next": true
  }
}

실패

HTTP 400 | 401 | 403 | 404 | 409 | 429 | 500
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "에러 메시지"
  }
}

필드 규칙

다음 단계

준비가 되셨다면 Quickstart 에서 첫 호출을 5분 안에 완료하실 수 있습니다. API Key / JWT 토큰이 필요하시면 help@ebut.co.kr 로 신청해 주세요.