상품번호 조회 API

Description

마스터번호 기준 Site번호 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/status Site번호 기준 마스터번호 조회 : [GET] https://sa2.esmplus.com/item/v1/site-goods/{siteGoodsNo}/goods-no

마스터번호 기준으로 Site번호를 조회하거나 Site번호 기준으로 마스터번호를 조회할 수 있습니다. Site번호 기준 마스터번호 조회시 1.0상품에서 2.0상품으로 전환한 상품인지 여부도 확인할 수 있습니다.

 

Request Description

항목	항목명	필수여부	Type	Description
GoodsNo	마스터 상품번호	Y	Path
StieGoodsNo	Site 상품번호	Y	Path

JSON
URL만 호출 / Request Body 없음

마스터상품번호 기준 Site상품번호 조회
[GET] https://sa2.esmplus.com/item/v1/goods/1158387297/status

Site상품번호 기준 마스터상품번호 조회
[GET] https://sa2.esmplus.com/item/v1/site-goods/1553307993/goods-no

 

Response Description

항목	항목명	Type	Description
isConverted	1.0→2.0 전환여부	boolean	조회 시 내려가는 정보
goodsNo	마스터상품번호	int	조회 시 내려가는 정보
resultCode	결과코드	int
message	메시지	string	실패 시 내려가는 정보
data	데이터	object	실패 시 내려가는 정보
sellManageCode	판매자 상품코드	string	마스터 상품 기준으로 각 Site에 등록된 상품번호를 조회 한 정보
innerResultCode	Site피딩관리코드	string	마스터 상품 기준으로 각 Site에 등록된 상품번호를 조회 한 정보
innerMessage	Site피딩관리코드메시지	string	마스터 상품 기준으로 각 Site에 등록된 상품번호를 조회 한 정보
siteDetail > gmkt > SiteGoodsNo	G마켓상품번호	string	마스터 상품 기준으로 각 Site에 등록된 상품번호를 조회 한 정보
siteDetail > gmkt > SiteGoodsComment	G마켓메시지	string	마스터 상품 기준으로 각 Site에 등록된 상품번호를 조회 한 정보
siteDetail > iac > SiteGoodsNo	옥션상품번호	string	마스터 상품 기준으로 각 Site에 등록된 상품번호를 조회 한 정보
siteDetail > iac > SiteGoodsComment	옥션메시지	string	마스터 상품 기준으로 각 Site에 등록된 상품번호를 조회 한 정보

 JSON_Success

마스터번호 기준
{
  "goodsNo": 0,
  "sellManageCode": "string",
  "innerResultCode": "string",
  "innerMessage": "string",
  "siteDetail": {
    "gmkt": {
      "SiteGoodsNo": "string",
      "SiteGoodsComment": "string"
    },
    "iac": {
      "SiteGoodsNo": "string",
      "SiteGoodsComment": "string"
    }
  }
}

Site번호 기준
{
  "isConverted": true,
  "goodsNo": 0
}

JSON_Fail

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

Sample Code_Success

마스터번호 기준
{
    "goodsNo": 1158387297,
    "sellManageCode": "",
    "innerResultCode": null,
    "innerMessage": null,
    "siteDetail": {
        "gmkt": {
            "SiteGoodsNo": "1553307993",
            "SiteGoodsComment": "성공"
        },
        "iac": {
            "SiteGoodsNo": "B629941783",
            "SiteGoodsComment": "성공"
        }
    }
}

Site번호 기준
{
    "goodsNo": 1158387297,
    "isConverted": false
}

전환 상품 조회시
{
 "isConverted":true,
 "goodsNo":1144092222
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"해당 판매자의 상품이 아닙니다."
}

 

Error Code

결과코드	메시지	원인
1000	해당 판매자의 상품이 아닙니다.	조회하려는 상품번호와 토큰 매칭이 되지 않을 경우