1.4 미니샵 카테고리조회 API – ESM Trading API

1.4 미니샵 카테고리조회 API

[GET] https://sa.esmplus.com/item/v1/categories/shop-cats/{shopCatCode}

Description
G마켓 / 옥션 판매자 미니샵 카테고리를 상품등록/수정 시 설정할 수 있습니다
ESM에서 G마켓 / 옥션 판매자 미니샵을 설정하시고 조회하시면 코드가 조회 가능합니다
Request Description
G마켓 판매자 미니샵은 G마켓 ID 토큰으로 조회합니다
옥션 판매자 미니샵은 옥션 ID 토큰으로 조회합니다
항목항목명필수여부TypeDescription
shopCatCode 미니샵 카테고리코드 Ypath 최초 대분류 전체 카테고리 조회시 아래 URL로 호출
[GET] https://sa.esmplus.com/item/v1/categories/shop-cats/
조회한 카테고리코드 기준 하위 카테고리 확인 가능
JSON
URL만 호출 / Request Body 없음
GET https://sa.esmplus.com/item/v1/categories/shop-cats/01000000

전체 카테고리 조회
GET https://sa.esmplus.com/item/v1/categories/shop-cats/

Response Description
항목항목명TypeDescription
resultCode 결과코드 int 0: 성공
나머지 : 실패
message 메시지 string 성공 or 실패사유
data 데이터 object
catCode 카테고리코드 string 조회대상의 하위카테고리 코드
catName 카테고리명 string 조회대상 카테고리명
IsLeaf 최하위 카테고리여부 boolean true : 최하위 카테고리일 경우
false : 하위 카테고리가 있을 경우

상품 등록/수정 시, 최하위 카테고리를 연동해야함
JSON_SuccessJSON_FailSample Code_SuccessSample Code_Fail
{
  "subCats": [
    {
      "catCode": "string",
      "catName": "string",
      "isLeaf": true
    }
  ]
}
{
   "ResultCode": 0,
   "Message": "string",
   "Data": {}
}
{
  "subCats":[
    {
     "catCode":"01000000",
     "catName":"명품화장품",
     "isLeaf":true
    }
  ]
}
{
  "ResultCode":1000,
  "Message":"Category is not exist. 오류카테고리코드",
  "Data":null
}
Error Code
결과코드메시지원인
1000카테고리 코드 오류입니다.존재하지 않는 카테고리코드 호출했을 경우