도서관 상세 조회 - Mint Starter Kit

GET

api

libraries

{libraryId}

도서관 상세 조회

curl --request GET \
  --url https://k-polaris.life/api/v1/libraries/{libraryId}

{
  "libraryId": 3372036854775808,
  "name": "구미시립양포도서관",
  "address": "경상북도 구미시 옥계북로 51",
  "latitude": 36.1387724,
  "longitude": 128.4187321,
  "homepageUrl": "https://lib.gumi.go.kr",
  "tel": "054-480-4770",
  "openNow": true,
  "todayOperatingHour": {
    "weekday": 1,
    "openTime": "09:00",
    "closeTime": "18:00",
    "closed": true
  },
  "weeklyOperatingHours": [
    {
      "weekday": 1,
      "openTime": "09:00",
      "closeTime": "18:00",
      "closed": true
    }
  ],
  "closedRules": [
    {
      "ruleType": "WEEKLY",
      "weekday": 1,
      "nthWeek": 2,
      "monthDay": 15
    }
  ],
  "bookmarked": true
}

Path Parameters

libraryId

integer<int64>

required

Response

200 - application/json;charset=UTF-8

성공

libraryId

string

도서관 ID입니다. 최대 길이는 19자입니다.

Example:

3372036854775808

name

string

도서관명입니다.

Example:

"구미시립양포도서관"

address

string

도서관 주소입니다.

Example:

"경상북도 구미시 옥계북로 51"

latitude

number<double>

도서관이 위치한 곳의 위도입니다.

Example:

36.1387724

longitude

number<double>

도서관이 위치한 곳의 경도입니다.

Example:

128.4187321

homepageUrl

string

도서관 홈페이지 URL입니다.

Example:

"https://lib.gumi.go.kr"

tel

string

도서관 전화번호입니다.

Example:

"054-480-4770"

openNow

boolean

도서관 운영 여부입니다.

Example:

true

todayOperatingHour

object

Show child attributes

weeklyOperatingHours

object[]

Show child attributes

closedRules

object[]

Show child attributes

bookmarked

boolean

주변 도서관 조회 쿼리 파리미터 <code>latitude</code>와 <code>longitude</code>에 해당하는 위도와 경도를 기준으로 쿼리 파라미터 <code>radiusKm</code> 반경에 위치한 도서관의 목록을 검색합니다. 응답의 <code>nextCursor</code> 값을 요청 시 쿼리 파라미터 <code>cursor</code>로 지정하면 해당 아이템 이후의 목록을 조회합니다. * 도서관 조회는 최대 60초 소요됩니다. 시간 초과 한도를 60초로 설정하세요. 비정상적으로 많은 요청을 보내면 HTTP 상태 코드 <code>429 Too Many Requests</code>가 응답될 수 있습니다.

도서관 상세 조회

curl --request GET \
  --url https://k-polaris.life/api/v1/libraries/{libraryId}

{
  "libraryId": 3372036854775808,
  "name": "구미시립양포도서관",
  "address": "경상북도 구미시 옥계북로 51",
  "latitude": 36.1387724,
  "longitude": 128.4187321,
  "homepageUrl": "https://lib.gumi.go.kr",
  "tel": "054-480-4770",
  "openNow": true,
  "todayOperatingHour": {
    "weekday": 1,
    "openTime": "09:00",
    "closeTime": "18:00",
    "closed": true
  },
  "weeklyOperatingHours": [
    {
      "weekday": 1,
      "openTime": "09:00",
      "closeTime": "18:00",
      "closed": true
    }
  ],
  "closedRules": [
    {
      "ruleType": "WEEKLY",
      "weekday": 1,
      "nthWeek": 2,
      "monthDay": 15
    }
  ],
  "bookmarked": true
}