안녕하세요? 카카오쇼핑입니다.
아래 3가지 내용이 신규 추가되어 안내드립니다.
- 선물하기 판매자 공지사항 API (등록/수정, 단건, 목록 조회, 전시종료, 삭제) 추가
- 상품 조회/수정/등록 시, 판매자 공지사항(noticeID) 필드 추가
- 이미지 업로드 type에 notice (판매자 공지사항) 추가
■ 적용일자: 2025/01/15 (수)
■ 상세 내용
1. 판매자 공지사항 API 신규 추가
| No | 신규 추가 API | API 문서 경로 |
| 1 |
- 판매자 공지사항 등록 : POST /v1/gift/notices - 판매자 공지사항 수정 : PUT /v1/gift/notices |
API 문서 확인하기 > |
| 2 |
판매자 공지사항 단건 조회 GET /v1/gift/notices?noticeId={noticeId} |
API 문서 확인하기 > |
| 3 |
판매자 공지사항 목록 조회 GET v1/gift/notices/display-status |
API 문서 확인하기 > |
| 4 |
판매자 공지사항 전시 종료 PUT v1/gift/notices/close |
API 문서 확인하기 > |
| 5 |
판매자 공지사항 삭제 DELETE /v1/gift/notices?noticeId={noticeId} |
API 문서 확인하기 > |
* 판매자 공지사항 상세 데이터 타입은 NoticeView 문서에서 확인 가능합니다.
2. 상품 조회/등록/수정 시, 판매자 공지사항 (noticeID) 필드 추가
1) 판매자 공지사항은 선택 입력 사항입니다.
2) 상품 수정 시, 기등록했던 공지사항을 유지하고 싶으시다면 공지사항 ID도 함께 요청 부탁드립니다. 해당 필드를 제외하고 요청할 경우, 기본값 (판매자 공지사항 설정 해제)으로 변경됩니다.
- 위 내용은 상품별 공지사항의 경우에만 해당됩니다. 전체 상품 공지사항의 경우, 상품 수정 시 공지사항 ID 필드를 제외해도 기존 설정값이 유지됩니다.
* 상세 API 문서 경로
- API Docs > 선물하기 상품 > 선물하기 상품 API 명세 > 상품 등록
- API Docs > 선물하기 상품 > 선물하기 상품 API 명세 > 상품 수정
- API Docs > 선물하기 상품 > 선물하기 상품 API 명세 > 상품 조회
3. 이미지 업로드 type > notice (판매자 공지사항) 추가
1) 판매자 공지사항 이미지를 등록할 경우, TYPE : NOTICE로 설정해 주세요.
2) 판매자 공지사항 사이즈는 최소 너비 1,080px 이상, 최대 높이 3,000px 이하로 등록해 주세요.
3) 이미지 파일의 형식은 jpg, jpeg, png 만 지원하며 10MB 를 초과할 수 없습니다.
* 상세 API 문서 경로 : API Docs > 선물하기 상품 > 선물하기 상품 API 명세 > 이미지 업로드
관련하여 궁금하신 점이 있을 경우, http://kko.to/G5xpSFS4j 을 통해 문의 부탁드립니다.
감사합니다.