상품 관리

상품을 등록, 수정, 동기화하고 목록을 조회할 수 있습니다.

상품 목록 조회

조건에 맞는 상품을 조회합니다.

GET https://papi.shoplive.cloud/v1/goods/{accessKey}

단일 상품 조회

상품 코드 혹은 상품의 URL로 조회할 수 있습니다.

상품 코드로 조회
GET https://papi.shoplive.cloud/v1/goods/{accessKey}/sku

상품 URL로 조회
GET https://papi.shoplive.cloud/v1/goods/{accessKey}/url

단일 상품 등록

단일 상품을 등록합니다. 상품 코드(sku) 또는 상품 URL(url)이 이미 존재하는 경우 등록할 수 없습니다.
상품의 이미지(url)는 없어도 등록이 가능합니다.

POST https://papi.shoplive.cloud/v1/goods/{accessKey}

단일 상품 수정(상품 ID로 수정)

상품 id로 상품을 찾아 정보를 수정합니다. 상품 id값이 반드시 필요합니다.
상품 url을 수정하고자 할 경우 상품 id 혹은 상품 코드(sku)로 수정해야 합니다.

PUT https://papi.shoplive.cloud/v1/goods/{accessKey}

단일 상품 수정(상품 코드로 수정)

상품 코드(sku)로 상품을 찾아 정보를 수정합니다.
상품 URL을 수정하고자 할 경우 상품 id 혹은 상품 코드(sku)로 수정해야 합니다.

PUT https://papi.shoplive.cloud/v1/goods/{accessKey}/sku

단일 상품 수정(상품 URL로 수정)

상품 URL(url)로 상품을 찾아 정보를 수정합니다. 상품 URL이 반드시 필요합니다.
상품 코드(sku)를 수정하고자 할 경우 상품 id 혹은 상품 URL로 수정해야 합니다.

PUT https://papi.shoplive.cloud/v1/goods/{accessKey}/url

다수 상품 동기화

여러 상품 목록에 대해 생성 혹은 수정하도록 한번에 동기화합니다.
상품의 id가 존재하면 해당 id로 상품을 찾아 수정합니다. 그렇지 않으면 상품 코드(sku) 혹은 URL(url)을 기준으로 상품의 기등록 여부를 판단하여 수정하거나 새롭게 등록합니다.

POST https://papi.shoplive.cloud/v1/goods/{accessKey}/sync

다수 상품 엑셀 동기화

SHOPLIVE 상품 등록 엑셀 형식에 맞는 파일을 첨부하여 상품을 등록 및 수정합니다.

POST https://papi.shoplive.cloud/v1/goods/{accessKey}/excel

단일 상품 삭제(상품 ID로 삭제)

상품 id에 해당하는 상품을 삭제합니다.

DELETE https://papi.shoplive.cloud/v1/goods/{accessKey}/{goodsId}

단일 상품 삭제(상품 코드로 삭제)

상품 코드(sku)에 해당하는 상품을 삭제합니다.

DELETE https://papi.shoplive.cloud/v1/goods/{accessKey}/sku

단일 상품 삭제(상품 URL로 삭제)

상품 URL(url)에 해당하는 상품을 삭제합니다.

DELETE https://papi.shoplive.cloud/v1/goods/{accessKey}/url