상품 등록 및 수정

카테고리/모델명/브랜드/제조사 검색, 원산지 전체목록, 판매자 주소록 조회, 이미지 업로드 API 등을 통해

상품등록 API의 요청 데이터를 구성해야 합니다.

product 패러미터에 들어가는 json object String 은 각 상품 옵션 유형별 샘플을 참고하세요.

등록 요청

<Content-type: application/x-www-form-urlencoded 요청>

POST /v1/store/product/register?product={} HTTP/1.1
Content-type: application/x-www-form-urlencoded;charset=utf-8

<Content-type: application/json 요청>

POST /v1/store/product/register HTTP/1.1
Content-type: application/json

$RequestBody

수정 요청

상품 수정 요청시, 변경 대상이 아닌 항목까지 포함하여 모든 상품정보 항목을 입력해서 전달해야 합니다. 누락시 해당 상품정보에 이전에 입력된 값은 삭제되며, 필수 입력 항목인 경우에는 Validation 오류가 납니다.

상품 수정 API 사용 중에는 다음과 같은 주의사항을 숙지하신 후 사용해야 합니다.
- 기존에 등록된 상품을 수정하는 요청시에는 반드시 모든 필드를 입력해야 합니다.
- 변경을 원하지 않는 필드를 제외하고 요청하는 경우, 해당 필드는 현재 상태 유지가 아닌 기본 값으로 변경 될 수 있습니다.
- 각 필드의 현재 상태를 알 수 없다면 상품 조회 Api를 사용해 전체 필드를 얻어 온 후,
해당 Object에서 변경을 원하는 필드만 수정해서 상품 수정 Api의 요청으로 사용해주시기 바랍니다.
- 각 요청 데이터 타입 항목의 각 수정 시 주의사항을 반드시 확인해야 합니다.
- 상세설명에 외부 이미지 url로 이미지를 넣으신 경우에도 상품 등록/수정시 카카오 내부 url로 변환해서 저장됩니다. 입력하신 이미지 url의 이미지가 수정된 경우에는 반드시 판매자센터>상품수정 화면을 통해 수정된 이미지를 다시 등록해 주셔야 합니다.

<Content-type: application/x-www-form-urlencoded 요청>

POST /v1/store/product/update?product={} HTTP/1.1
Content-type: application/x-www-form-urlencoded;charset=utf-8

<Content-type: application/json 요청>

POST /v1/store/product/update HTTP/1.1
Content-type: application/json

$RequestBody

응답

요청 성공하면 상품번호를 리턴합니다.

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
   "productId" : 1
}