등록된 연관 상품 그룹을 삭제합니다.
연관상품 그룹 삭제
- 본인 스토어에 기 등록된 연관상품 그룹만 삭제가 가능합니다. - 연관상품 그룹 조회 기능을 활용하여 정확한 연관상품 그룹번호를 확인하신 후 삭제하시기 바랍니다.
요청
DELETE /v2/store/related-group?id={id} HTTP/1.1
<요청 예시>
DELETE /v2...
더보기
판매자가 등록한 연관 상품 그룹을 조회합니다.
- 연관상품 그룹 전체 목록 조회 : 스토어에 등록된 연관상품 그룹 전체 목록을 조회합니다. - 연관상품 그룹 개별 조회 : 특정 연관상품 그룹번호로 조회 시, 해당 연관상품 그룹에 등록된 상품번호를 포함한 상세 내역 조회가 가능 합니다. ...
더보기
연관상품 그룹을 등록하거나 수정합니다.
연관상품 그룹 등록
- 연관상품 번호는 자동 채번됩니다.- 연관상품 그룹명은 중복되지 않게 입력해야 합니다. - 연관상품 그룹당 상품은 최소 2개에서 최대 15개까지 설정 가능합니다. - 스토어당 연관상품 그룹은 최대 50개까지만 등록할 수 있습니다.
연관상품 그룹 수정
- 본인 스토어에 기 등록된 연관상품 ...
더보기
상품정보고시 상품군별 입력해야할 필드 목록과 필드에 대한 설명을 조회합니다.
필드 조회
<Content-type: json 요청>
GET /v2/store/announcement?type={type} HTTP/1.1
키
타입
필수여부
설명
type
String
필수
상품정보고시 상품군별 상세 필드 조회 API응답 목록 참조
...
더보기
상품정보고시 상품군 목록을 조회합니다.
상품 등록시 입력하는 AnnouncementInfo에 announcementType 필드에 사용할 수 있는 값들입니다.
조회 요청
GET /v2/store/announcements HTTP/1.1
ResponseBody
키
타입
필수여부
설명
result
Map<String, ...
더보기
상품의 가격을 수정할 때 사용합니다.
(해당 상품이 이미 등록되어 있어야 하며, 존재하지 않는 경우 변경이 적용되지 않고 무시처리됩니다.)
value 필드는 설정하고자 하는 값에 대한 필드입니다.
상품 가격 변경 단위(PriceUpdateUnit)에는 RATE(정률)와 PRICE(정액)이 있으며,
상품 가격 변경 방식(PriceUpdateMetho...
더보기
등록한 상품을 일괄 영구 삭제하는 API 입니다.
상품 삭제시 더이상 상품 조회가 불가능하고 판매중 상태로 복구가 불가능합니다.
삭제하고자 하는 상품 ID 목록을 전달하여 삭제하며 유효하지 않은 상품 ID는 무시됩니다.
현재 진행중인 주문이 있는 경우에는 삭제되지 않습니다.
삭제 요청
<Content-type: application/json 요...
더보기
카테고리/모델명/브랜드/제조사 검색, 원산지 전체목록, 판매자 주소록 조회, 이미지 업로드 API 등을 통해
상품등록 API의 요청 데이터를 구성해야 합니다.
product 패러미터에 들어가는 json object String 은 각 상품 옵션 유형별 샘플을 참고하세요.
등록 요청
<Content-type: application/x-www-form...
더보기
전체 상품정보를 필요로 할 때 사용합니다. 상품번호 또는 판매자 상품코드로 조회 할 수 있습니다.
판매자 상품코드로 조회시에는 상품정보가 배열 형태로 반환됩니다.
(판매자 상품코드에 대해 유일성 체크를 하지 않으므로 배열 형식을 사용합니다.)
상품 조회에 반환되는 타입은 productId와 productSaleStatus가 추가로 들어가며 그 외는 P...
더보기
등록된 상품을 페이지 단위로 조회하기 위해 사용합니다.
정렬기준의 종류는 SortProperty 를 참고 해 주시고 정렬 순서는 기준별 역순입니다.
요청
GET /v1/store/products?page=1&size=100&productOrder=CREATED_AT&pageOrder=ASC HTTP/1.1
<요청 패러미터 설명>
키
타입...
더보기
등록된 상품을 페이지 단위로 조회하기 위해 사용합니다. page*size 최대 5만개 제한으로 조회할 수 있습니다.
정렬기준의 종류는 SortProperty 를 참고 해 주시고 정렬 순서는 기준별 역순입니다.
요청
GET /v2/store/products/by-page?page=1&size=100&sortProperty=CREATED_AT&sort...
더보기
페이지 제한없이 대량 상품을 조회하기 위해 사용합니다.
정렬기준의 종류는 SortProperty 를 참고 해 주시고 정렬 순서는 기준별 역순입니다.
최초 조회 요청(cursor 값 없이 요청)시, 해당 조회 문서의 마지막 위치를 nextCursor 로 응답. cursor 입력 후 요청 시 해당 커서 이후의 상품목록이 조회됩니다.
(예시)
1) ...
더보기
특정 상품의 옵션 등록/수정 시에 사용합니다.
옵션 등록/수정 시에는 본 상품이 이미 등록되어 있어야 하며, 본 상품을 찾을 수 없는 경우 에러가 발생됩니다.
각 옵션의 id값은 등록시에 자동으로 생성되며, 옵션 조회 api를 통해 확인할 수 있습니다.
상품 하위에 옵션을 신규 등록하는 경우에는 옵션 리스트 내 id 필드는 빈 값으로 입력하시고, 수정...
더보기
특정 상품에 대한 등록된 모든 옵션 정보를 조회하기 위해 사용합니다.
요청
GET /v1/store/product/option?productId={productId}
<요청 패러미터>
키
타입
필수여부
설명
productId
Long
필수
상품번호
응답
조회 결과 응답 바디 내용은 옵션 유형에 따라 다르므로, Option 영...
더보기
상품 판매상태를 판매중 또는 판매중지 상태로 변경할 수 있습니다.
주의사항
현재 상품의 상태가 판매대기 또는 판매중인 경우에만 판매중지 상태로 수정할 수 있습니다.
판매중지 상태에서만 판매중 상태로 수정할 수 있습니다.
요청
POST /v1/store/product/update?productId={}&saleStatus={} HTTP/1.1...
더보기
상품 상세설명 html에 외부 이미지 url이 포함된 경우 ‘상세설명 이미지 업데이트’ 요청을 할 수 있습니다.카카오톡 스토어에서는 상세설명 html에 포함된 외부 이미지 url이 포함된 경우에도 개별 이미지를 톡스토어에 저장, 모바일에 최적화된 이미지로 변환해서 상품 상세 화면에 노출하고 있습니다. 따라서 외부 이미지 호스팅에서 이미지 url은 변경...
더보기
톡스토어 상품 이미지 등록 시, 카카오 이미지 서버에 이미지 업로드 후 카카오에서 응답된 이미지 url을 입력하셔야 합니다.이를 위해 상품에 필요한 이미지를 비동기로 업로드 해주세요.
주의사항
이미지 파일의 형식은 jpg, jpeg, png만 지원하며 10MB를 초과할 수 없습니다.이미지 비율은 1:1 또는 3:4 중 선택 입력해 주세요.이미지 사이...
더보기
톡스토어 옵션 이미지 등록 시, 카카오 이미지 서버에 이미지 업로드 후 카카오에서 응답된 이미지 url을 입력하셔야 합니다.이를 위해 옵션에 필요한 이미지를 비동기로 업로드 해주세요.
주의사항
이미지 파일의 형식은 jpg, jpeg, png만 지원하며 10MB를 초과할 수 없습니다.옵션 이미지 비율은 1:1, 750X750 이상의 사이즈를 권장합니다...
더보기
상품 이미지 비동기 업로드 요청, 옵션 이미지 비동기 업로드 요청의 업로드 완료를 확인합니다.업로드 요청 API 에서의 결과 url 을 해당 API 의 패러미터로 사용하여 업로드 요청한 이미지의 업로드 완료를 확인합니다.
주의사항
업로드 요청 이미지의 확인 가능 시간은 10분 이내 입니다. 업로드 요청을 하고 10분 이내에 확인 요청을 할 때만 유...
더보기
새로운 공지사항을 등록하거나, 기존 공지사항을 수정합니다.
등록 요청
<Content-type: application/x-www-form-urlencoded 요청>
POST /v1/store/notice/register?notice={} HTTP/1.1
Content-type: application/x-www-form-urlencoded;chars...
더보기
판매자가 등록한 전체 혹은 특정번호의 공지사항을 조회합니다.
(단, 현재 노출가능한 상태가 아닐 경우 조회되지 않습니다)
요청
하나의 공지사항을 조회하는 경우 noticeId 패러미터에 공지사항 아이디를 넣어서 보냅니다.
패러미터가 없는 경우 전체 공지사항 목록이 조회됩니다.
GET /v1/store/notices?noticeId={noticeI...
더보기
톡스토어 사용자가 특정 상품에 남긴 문의사항에 대한 답변을 등록/수정합니다.
등록/수정 요청
POST /v1/store/qna/answer HTTP/1.1
Content-type: application/x-www-form-urlencoded;charset=utf-8
<Content-type: application/x-www-form-urlen...
더보기
판매자 등록상품들에 사용자들이 문의한 문의내역을 전체 혹은 특정번호의 문의내용을 조회합니다.
요청
하나의 상품 문의 내역을 조회하는 경우 qnaId 패러미터에 상품문의 아이디를 넣어서 보냅니다.
패러미터가 없는 경우 전체 공지사항 목록이 조회됩니다.
GET /v1/store/qna?page=&size=&qnaId=&buyExist=&answerE...
더보기
톡스토어의 카테고리 전체 목록 또는 상품 등록이 가능한 최하위 카테고리 전체 목록을 조회합니다.카테고리의 level은 대/중/소/세의 4단계이며, 순서대로 1부터 4까지 존재합니다.
요청
최하위 카테고리만 조회하는 경우 leafOnly 패러미터에 true 값을 설정해서 요청합니다.
GET /v1/store/categories?leafOnly={tr...
더보기
특정 카테고리 id(category_id)로 하위카테고리의 목록을 조회합니다. category_id 패러미터가 없는 경우 대분류 카테고리 목록이 조회됩니다.하위카테고리가 존재하지 않는 경우에는 빈 목록이 반환됩니다.
요청
GET /v1/store/sub_categories?categoryId={categoryId}
<요청 패러미터 설명>
...
더보기
카테고리명에 특정 키워드(query)가 포함된 전체 리프 카테고리 목록을 조회합니다.
요청
GET /v1/store/categories/search?keyword={keyword}
<요청 패러미터 설명>
키
타입
필수여부
설명
keyword
String
필수
검색 키워드
응답
요청이 성공하면, 응답 바디에 매칭된 리프...
더보기
원산지 전체 목록을 조회합니다.원산지 level 정보는 0, 1, 2 까지이며 code 값으로 하위 관계가 표시됩니다.
요청
GET /v1/store/origin_area
응답
전체 원산지 정보 목록를 반환합니다.
<응답 바디>
타입
필수여부
설명
Array<OriginArea>
필수
원산지 정보 목록
<응답 바...
더보기