도서 API | Notion

전체 도서 조회 : 검색이나 전체 도서 목록 SELECT

Method	GET
URI	/books?limit={page당 도서 수}&currentPage={현재 page}
HTTP Status Code	200 : 성공
500 : SELECT 에러
Request Body
Response Body	// 도서 상세 정보를 포함합니다.
// 필요한 데이터만 선정해서 구현 부탁드립니다.
{

books : 
    [
        {
            id : “도서 아이디”,
            title : “도서 제목”,
            img : picsum img id,
            summary : “요약 설명”,
            author : “도서 작가”,
            price : “가격”,
            likes : “좋아요 수”,
            pubDate : “출간일”
        },
        {
            id : “도서 아이디”,
            title : “도서 제목”,
            img : picsum img id,
            summary : “요약 설명”,
            author : “도서 작가”,
            price : “가격”,
            likes : “좋아요 수”,
            pubDate : “출간일”
        },
        …
    ],
// 총 페이지는 프론트에서 도서 수로 계산
pagenation : {
    currentPage : 현재 페이지
    totalCount : 총 도서 수
}

} |

개별 도서 조회 : 도서 상세 정보 SELECT
- 좋아요 여부를 표시하기 위해 JWT Token 사용
- 로그인 상태가 아니면 liked를 제외하고 response

Method	GET
URI	/books/{bookId}
HTTP Status Code	200 : 성공
500 : SELECT 에러
Request Header	“Authorization” : 로그인할 때 받은 JWT Token (문자열)
Request Body
Response Body	{

id : “도서 아이디”,
title : “도서 제목”,
img : picsum img id,
category : “카테고리”,
format : “포맷”,
isbn : “isbn”,
summary : “요약 설명”,
description : “상세 설명”,
author : “도서 작가”,
pages : “쪽 수”,
index : “목차”,
price : “가격”,
likes : “좋아요 수”,
liked : boolean, (로그인 상태에만 보내줌)
pubDate : “출간일”

} |

카테고리 별 도서 조회 : 카테고리 별 도서 SELECT
- 화면에 category를 select하는 별도의 API 필요
- queryString - news가 false면 모든 도서, true면 신간 조회
- 신간 구분은 select 시 news 조건에 따라 출간일 WHERE조건

Method	GET
URI	/books?categoryId={category_id}&news=true&limit={page당 도서 수}&currentPage={현재 page}
HTTP Status Code	200 : 성공
500 : SELECT 에러
Request Body
Response Body	// 도서 상세 정보를 포함합니다.
// 필요한 데이터만 선정해서 구현 부탁드립니다.
{

books : 
    [
        {
            id : “도서 아이디”,
            title : “도서 제목”,
            img : picsum img id,
            summary : “요약 설명”,
            author : “도서 작가”,
            price : “가격”,
            likes : “좋아요 수”,
            pubDate : “출간일”
        },
        {
            id : “도서 아이디”,
            title : “도서 제목”,
            img : picsum img id,
            summary : “요약 설명”,
            author : “도서 작가”,
            price : “가격”,
            likes : “좋아요 수”,
            pubDate : “출간일”
        },
        …
    ],
// 총 페이지는 프론트에서 도서 수로 계산
pagenation : {
    currentPage : 현재 페이지
    totalCount : 총 도서 수
}

} |