카테고리/모델명/브랜드/제조사 검색, 원산지 전체목록, 판매자 주소록 조회, 이미지 업로드 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
<요청 패러미터 설명>
키
타입...
더보기
특정 상품의 옵션 등록/수정 시에 사용합니다.
옵션 등록/수정 시에는 본 상품이 이미 등록되어 있어야 하며, 본 상품을 찾을 수 없는 경우 에러가 발생됩니다.
각 옵션의 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>
필수
원산지 정보 목록
<응답 바...
더보기
모델명에 특정 키워드가 포함되는 모델 정보를 조회할 수 있습니다.
상품 등록시 모델명 검색 결과로 응답받은 modelId를 입력하는 경우, 해당 모델명에 매핑된 브랜드 및 제조사명이 상품 정보로 자동 입력됩니다.
모델명 검색은 paging을 지원합니다.
요청
검색하려는 키워드를 패러미터에 넣어서 요청합니다.
GET /v1/store/search?m...
더보기
브랜드명에 특정 키워드가 포함되는 브랜드 리스트를 조회할 수 있습니다.
브랜드 검색 요청은 paging을 지원합니다.
요청
검색하려는 키워드를 패러미터에 넣어서 요청합니다.
GET /v1/store/search?brand={brand}
<요청 패러미터 설명>
키
타입
필수여부
설명
brand
String
필수
브랜드 검색 키워드
...
더보기
제조사명에 특정 키워드가 포함되는 제조사명 리스트를 조회할 수 있습니다.
제조사 검색 요청은 paging을 지원합니다.
요청
검색하려는 키워드를 패러미터에 넣어서 요청합니다.
GET /v1/store/search?manufacturer={manufacturer}
<요청 패러미터 설명>
키
타입
필수여부
설명
manufacturer...
더보기
