Qnector
로그인

재고 API

품목별 재고 합계 조회 및 수량 수정 API입니다.

엔드포인트

구분설명

GET /inventory

품목별 재고 스냅샷 (inventory:read)

PUT /inventory

재고 수량 수정 (inventory:write)

재고 조회

품목별 재고 수량을 반환합니다.

엔드포인트 예시

GET /inventory

품목별 재고 스냅샷 (inventory:read)

응답 예시 (200)

json
{
  "data": [
    {
      "prod_code": "SKU-001",
      "prod_name": "사과 5kg",
      "category": "과일",
      "quantity": 120,
      "last_updated": "2026-06-26T12:00:00Z"
    },
    {
      "prod_code": "SKU-002",
      "prod_name": "배 3kg",
      "category": "과일",
      "quantity": 45,
      "last_updated": "2026-06-25T18:00:00Z"
    }
  ],
  "meta": {
    "total": 2
  },
  "errors": []
}

재고 수정

요청당 1개 품목(prod_code)만 지원합니다.

  • quantity: 0 ~ 9,999,999 정수
json
{
  "prod_code": "SKU-001",
  "quantity": 120
}

엔드포인트 예시

PUT /inventory

재고 수량 수정 (inventory:write)

요청 예시

json
{
  "prod_code": "SKU-001",
  "quantity": 120
}

응답 예시 (200)

json
{
  "data": {
    "success": true
  },
  "meta": {},
  "errors": []
}