HomeAboutMeBlogGuest
© 2025 Sejin Cha. All rights reserved.
Built with Next.js, deployed on Vercel
♥️
2기 최종 프로젝트 팀별 공간
/
[팀 08] 사이코
[팀 08] 사이코
/
📶
API 설계
/
📃
상품 검색
📃

상품 검색

Method
GET
URL Patterns
api/v1/products
인증 필요 여부
X
시퀀스 다이어그램
상품을 검색한다.
  • title (선택)
    • 제목 검색
    • 최대 32자
  • progressed (필수)
    • 낙찰 진행 여부 확인
    • true로 보낼 경우 → 낙찰 진행 중 상품만 검색
    • false로 보낼 경우 → 낙찰 끝난 상품만 검색
  • category (선택)
    • 검색 카테고리 (1개만 가능)
    • 영어 이름으로 보내주셔야 합니다. 디지털 기기 아니고 DIGITAL_DEVICE
    • 전체 조회시에 ALL 로 전송
  • offset (필수)
    • 상품 번호(index)
    • 0부터 시작
  • limit (필수)
    • 한번에 받아오는 상품 개수
    • 1부터 시작
  • sort (선택)
    • 정렬 조건
      • 최신순: CREATED_AT_DESC
      • 시작가 오름차순: MINIMUM_PRICE_ASC
      • 시작가 내림차순: MINIMUM_PRICE_DESC
      • 종료 임박순: END_DATE_ASC
    • 정렬 조건 안보내주면 기본으로 종료 임박순 정렬

요청

Get api/v1/products?title=&progressed=&category=&offset=&limit=&sort

응답

200 OK [ { "id": Number, "title": String, "thumbnailImage": String, "minimumPrice": Number, "expireAt": Date, "createdAt": Date, "updatedAt": Date, }, {} // 유사 데이터 limit 개수만큼 반환 ]