# Mint Starter Kit ## Docs - [갱신 기록](https://polaris.nimonic.dev/api-reference/file.md) - [소개](https://polaris.nimonic.dev/api-reference/introduction.md): 각 API 기능과 요청 방법, 응답 값 등의 정보를 제공합니다. - [주변 도서관의 도서 소장 정보 조회](https://polaris.nimonic.dev/api-reference/도서-가능-여부/주변-도서관의-도서-소장-정보-조회.md):
쿼리 파리미터 latitude와 longitude에 해당하는 위도와 경도를 기준으로 쿼리 파라미터 radiusKm 반경에 위치한 도서관의 목록을 검색한 후 쿼리 파라미터 isbn에 해당하는 도서를 각 도서관이 소장하고 있는지 조회합니다.
응답의 nextCursor 값을 요청 시 쿼리 파라미터 cursor로 지정하면 해당 아이템 이후의 목록을 조회합니다.
* 주변 도… - [도서 추천/비추천 투표](https://polaris.nimonic.dev/api-reference/도서-투표/도서-추천비추천-투표.md):
인증된 사용자가 특정 도서에 추천 또는 비추천 투표를 합니다.
같은 도서에 다시 투표하면 새 투표를 만들지 않고 기존 투표 값을 수정합니다.
투표 값은 RECOMMEND, NOT_RECOMMEND만 허용됩니다.
해당하는 ISBN에 대한 도서의 정보를 조회합니다.
- [도서 조회](https://polaris.nimonic.dev/api-reference/도서/도서-조회.md):쿼리 파라미터 query에 해당하는 검색어와 연관된 도서의 목록을 검색합니다.
응답의 nextCursor 값을 요청 시 쿼리 파라미터 cursor로 지정하면 해당 아이템 이후의 목록을 조회합니다.
* 도서 조회는 최대 60초 소요됩니다. 시간 초과 한도를 60초로 설정하세요. 비정상적으로 많은 요청을 보내면 HTTP 상태 코드 429 Too Many Requests가 응답될 수 있습니다.
해당하는 libraryId에 대한 도서관의 정보를 조회합니다.
쿼리 파리미터 latitude와 longitude에 해당하는 위도와 경도를 기준으로 쿼리 파라미터 radiusKm 반경에 위치한 도서관의 목록을 검색합니다.
응답의 nextCursor 값을 요청 시 쿼리 파라미터 cursor로 지정하면 해당 아이템 이후의 목록을 조회합니다.
* 도서관 조회는 최대 60초 소요됩니다. 시간 초과 한도를 60초로 설정하세요. 비정상적으로 많은 요청을 보내면… - [현재 사용자 조회](https://polaris.nimonic.dev/api-reference/사용자/현재-사용자-조회.md) - [내 알림 구독 목록 조회](https://polaris.nimonic.dev/api-reference/알림/내-알림-구독-목록-조회.md):
인증된 사용자가 등록한 도서 대출 가능 알림 구독 목록을 조회합니다.
사용자가 어떤 도서와 도서관 조합에 대해 알림을 받고 있는지 확인하는 역할을 합니다.
- [도서 대출 가능 알림 구독 등록](https://polaris.nimonic.dev/api-reference/알림/도서-대출-가능-알림-구독-등록.md):인증된 사용자가 특정 도서와 도서관 조합에 대한 대출 가능 알림을 구독합니다.
구독한 도서가 해당 도서관에서 대출 가능 상태가 되면 알림 발송 대상이 되도록 등록하는 역할을 합니다.
이미 비활성화된 구독이 있으면 새 구독을 만들지 않고 다시 활성화합니다.
- [도서 대출 가능 알림 구독 삭제](https://polaris.nimonic.dev/api-reference/알림/도서-대출-가능-알림-구독-삭제.md):인증된 사용자가 특정 도서와 도서관 조합에 대한 대출 가능 알림 구독을 비활성화합니다.
사용자가 더 이상 해당 도서와 도서관 조합의 대출 가능 알림을 받지 않도록 구독을 해제하는 역할을 합니다.
- [푸시 토큰 등록](https://polaris.nimonic.dev/api-reference/알림/푸시-토큰-등록.md):인증된 사용자의 앱 푸시 토큰을 등록하거나 다시 활성화합니다.
사용자가 도서 대출 가능 알림을 받을 수 있도록 플랫폼과 기기 토큰을 서버에 연결하는 역할을 합니다.
플랫폼 값은 ANDROID, IOS만 허용됩니다.
인증된 사용자의 앱 푸시 토큰을 비활성화합니다.
사용자가 더 이상 해당 기기로 알림을 받지 않도록 플랫폼과 기기 토큰의 연결을 해제하는 역할을 합니다.
- [Kakao 로그인](https://polaris.nimonic.dev/api-reference/인증/kakao-로그인.md): Kakao 로그인 페이지로 이동합니다. - [로그아웃 또는 토큰 무효화](https://polaris.nimonic.dev/api-reference/인증/로그아웃-또는-토큰-무효화.md): 로그아웃을 위해 리프레시 토큰을 무효화합니다. 액세스 토큰이 저장돼 있다면 잠시 동안 로그인 상태일 수 있으므로 삭제해야 합니다. - [인증 토큰 발급](https://polaris.nimonic.dev/api-reference/인증/인증-토큰-발급.md):Kakao 로그인 후 발급된 코드로 로그인할 수 있는 액세스 토큰 및 리프레시 토큰을 발급합니다.
액세스 토큰은 메모리에 저장 후 Authorization 헤더에 담아 전송해야 합니다.
리프레시 토큰은 쿠키나 Keychain, Keystore에 저장하고 /api/v1/auth/refresh로 요청할 때만 전송하도록 해야 합니다.
액세스 토큰은 10분(600초), 리프레시 토큰은 1년(31536000초) 간 유효합니다.
- [인증 토큰 재발급](https://polaris.nimonic.dev/api-reference/인증/인증-토큰-재발급.md): 리프레시 토큰을 사용해 액세스 토큰을 재발급하고 기존 리프레시 토큰을 무효화합니다. - [도서 찜 등록](https://polaris.nimonic.dev/api-reference/찜/도서-찜-등록.md) - [도서 찜 해제](https://polaris.nimonic.dev/api-reference/찜/도서-찜-해제.md) - [도서관 찜 등록](https://polaris.nimonic.dev/api-reference/찜/도서관-찜-등록.md) - [도서관 찜 해제](https://polaris.nimonic.dev/api-reference/찜/도서관-찜-해제.md) - [찜한 도서 목록 조회](https://polaris.nimonic.dev/api-reference/찜/찜한-도서-목록-조회.md) - [찜한 도서관 목록 조회](https://polaris.nimonic.dev/api-reference/찜/찜한-도서관-목록-조회.md) ## OpenAPI Specs - [api-docs](https://polaris.nimonic.dev/api-docs.json) - [openapi](https://polaris.nimonic.dev/api-reference/openapi.json)