Skip to main content
GET
/
api
/
v1
/
book-availability
주변 도서관의 도서 소장 정보 조회
curl --request GET \
  --url http://localhost:8080/api/v1/book-availability
{
  "hasNext": true,
  "nextCursor": "<string>",
  "items": [
    {
      "libraryId": 123,
      "name": "<string>",
      "address": "<string>",
      "latitude": 123,
      "longitude": 123,
      "distanceKm": 123,
      "hasBook": true,
      "loanAvailable": true,
      "availabilityStatus": "AVAILABLE",
      "openNow": true
    }
  ]
}

Query Parameters

isbn
string
required

도서의 ISBN입니다. 13자리 값이어야 합니다.

latitude
number<double>
required

조회하려는 위치의 위도입니다. -90.0 ~ +90.0 사이의 값이어야 합니다.

longitude
number<double>
required

조회하려는 위치의 경도입니다. -180.0 ~ +180.0 사이의 값이어야 합니다.

radiusKm
number<double>
default:5

조회하려는 위치에서 탐색할 범위입니다. 이는 원의 반지름이며, 조회하려는 위치가 원의 중심이 됩니다.

loanAvailable
boolean

요청 시각에 대출 가능한 도서관만 출력할지 결정합니다. false이면 대출 가능 여부에 상관 없이 조회합니다.

openNow
boolean

요청 시각에 운영 중인 도서관만 출력할지 결정합니다. false이면 운영 여부에 상관 없이 조회합니다.

cursor
string

특정 도서관 아이템 이후의 도서관 아이템을 조회할 때 사용합니다.

limit
integer<int32>
default:20

한 번에 응답 받을 도서관의 개수이고 기본값은 10이고 최대값은 100입니다.

Response

200 - application/json;charset=UTF-8

성공

hasNext
boolean
nextCursor
string
items
object[]