Qnector
로그인

창고 API

판매자 창고 목록 조회 및 생성·수정 API입니다.

엔드포인트

구분설명

GET /warehouses

창고 전체 목록 (warehouses:read)

POST /warehouses

창고 생성 (warehouses:write)

PATCH /warehouses

창고 수정 — body에 warehouse_code로 대상 지정 (warehouses:write)

목록 조회

페이징 없이 전체 목록을 반환합니다.

엔드포인트 예시

GET /warehouses

창고 전체 목록 (warehouses:read)

응답 예시 (200)

json
{
  "data": [
    {
      "warehouse_code": "WH-01",
      "warehouse_name": "본사 창고",
      "is_from_ecount": false
    },
    {
      "warehouse_code": "WH-02",
      "warehouse_name": "이카운트 동기 창고",
      "is_from_ecount": true
    }
  ],
  "meta": {},
  "errors": []
}

창고 생성

json
{
  "warehouse_code": "WH-01",
  "warehouse_name": "본사 창고"
}

엔드포인트 예시

POST /warehouses

창고 생성 (warehouses:write)

요청 예시

json
{
  "warehouse_code": "WH-01",
  "warehouse_name": "본사 창고"
}

응답 예시 (200)

json
{
  "data": {
    "warehouse_code": "WH-01",
    "warehouse_name": "본사 창고",
    "is_from_ecount": false
  },
  "meta": {},
  "errors": []
}

창고 수정

본문의 warehouse_code로 수정 대상을 지정합니다.

json
{
  "warehouse_code": "WH-01",
  "warehouse_name": "본사 중앙 창고"
}

엔드포인트 예시

PATCH /warehouses

창고 수정 (warehouses:write)

요청 예시

json
{
  "warehouse_code": "WH-01",
  "warehouse_name": "본사 중앙 창고"
}

응답 예시 (200)

json
{
  "data": {
    "warehouse_code": "WH-01",
    "warehouse_name": "본사 창고",
    "is_from_ecount": false
  },
  "meta": {},
  "errors": []
}

이카운트 연동 창고

  • is_from_ecount=true인 창고는 PATCH 수정 시 403 ecount_managed
  • warehouse_code는 seller 내 유일, 최대 50자