지마켓, 옥션 카테고리 조회 API

Description

[GET] https://sa2.esmplus.com/item/v1/categories/site-cats/{siteCatCode} (하위카테고리 개별 조회시) [GET] https://sa2.esmplus.com/item/v1/categories/site-cats (대분류 전체 조회시)

G마켓, 옥션 사이트 카테고리 조회하여 상품 등록시 필수로 입력합니다. (leaf 카테고리로 상품 등록 가능) 사이트별 개별 조회시 해당 사이트 ID 1개만 입력된 인증토큰으로 호출 해주시면 됩니다. 참고 url ) 옥션 카테고리 xml 링크 : https://script.auction.co.kr/category/categories.xml (IsLeaf="true" 경우 상품 등록 가능)

Request Description

항목	항목명	필수여부	Type	Description
siteCatCode	G마켓/옥션 카테고리코드	Y	path	대분류 전체 카테고리 조회시 아래 URL로 호출 [GET] https://sa2.esmplus.com/item/v1/categories/site-cats 조회한 카테고리코드 기준 하위 카테고리 확인 가능

JSON
URL만 호출 / Request Body 없음
[GET] https://sa2.esmplus.com/item/v1/categories/site-cats/100000002

전체 카테고리 조회 - 사이트별 대분류 조회 가능
[GET] https://sa2.esmplus.com/item/v1/categories/site-cats

 

Response Description

항목	항목명	Type	Description
resultCode	결과코드	int	0: 성공 나머지 : 실패
message	메시지	string	성공 or 실패사유
catCode	카테고리코드	string	조회대상 카테고리 코드 subCats Object는 하위카테고리코드
catName	카테고리명	string	조회대상 카테고리명 subCats Object는 하위카테고리명
isLeaf	최하위 카테고리여부	boolean	true : 최하위 카테고리일 경우 false : 하위 카테고리가 있을 경우 subCats Object는 하위카테고리의 최하위카테고리 여부 상품 등록/수정 시, 최하위 카테고리를 연동해야함

JSON_Success

{
  "catCode": "string",
  "catName": "string",
  "isLeaf": true,
  "subCats": [
    {
      "catCode": "string",
      "catName": "string",
      "isLeaf": true
    }
  ]
}

JSON_Fail

{
   "resultCode": 0,
   "message": "string"
}

Sample Code_Success

{
   "catCode":"100000002",
   "catName":"노트북/PC",
   "isLeaf":false,
   "subCats":[
  {
   "catCode":"200001091",
   "catName":"노트북 주변기기",
   "isLeaf":false
  },
  {
   "catCode":"200002089",
   "catName":"태블릿 PC",
   "isLeaf":false
   },
   {
   "catCode":"200001699",
   "catName":"조립PC",
   "isLeaf":false
   }
  ]
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"Category is not exist. 오류카테고리코드"
}

 

Error Code

결과코드	코드메시지	원인
8668	ShowAlertException$재발송 완료 배송건이 없습니다	재발송 완료 처리 가능한 상태가 아닐 경우
8668	이미 완료 처리 되었습니다	재발송 완료 처리 가능한 상태가 아닐 경우