Catalog Search
/library-service?type=0
Home Page
This page provides services such as keyword search for library collections, new book introductions, most viewed rankings, and important information.
Keyword Search
/library-service/keyword-search
Enter a keyword, click on a popular keyword, or select a recent search to query the library catalog.
Books found will be displayed below. Clicking on a book will navigate to its detailed page. For more details, see Book Details.
If no results are found, it will display as follows:
Most Viewed Rankings
By default, the top five rankings are displayed, as shown below:
Clicking "More" navigates to the most viewed ranking list page, sorted by view count from highest to lowest, displaying up to 100 records.
Clicking on a book navigates to its detailed page. For more details, see Book Details.
Important Information
By default, the top three records are displayed, as shown below:
Clicking "More" navigates to the important information list page, sorted by release date from newest to oldest.
If the data is set to an external website, clicking the message will open a new window linking to the specified URL.
If the data is set to message content, clicking the message navigates to the detailed message page, as shown below:
Book Details
/library-service/book-detail/:id
This page displays detailed information about a book, including cover image, title, author, publication details, subject, ISBN, and the number of reservation requests. Available copies for reservation are displayed below.
For a single copy, it is displayed as follows:
For multiple copies, the numbers are displayed sequentially, allowing users to select the desired copies for reservation:
Choose a Pickup Library
After selecting the desired copies for reservation, the user must choose a pickup library to complete the reservation.
Choose by distance:
Choose by administrative district:
If the reservation is successful, a pop-up window will appear showing success and the number of books reserved, along with the pickup library.
Clicking the "View Reservation List" button navigates to "My Records". For more details, see My Records. Clicking the "Return to Home" button navigates back to the catalog search page.
If the reservation fails, a pop-up window will display the reason for failure.
The maximum number of reservations per session is 7. If exceeded, a prompt will appear as follows:
Notice
Books that have already been reserved cannot be reserved again.
If the current reservation includes books that have already been reserved, they will be skipped, and only unreserved books will be processed.
If all books in the current reservation are already reserved, a reservation failure message will be displayed.The reservation limit is 7 books.
Data Display
API Design - Book List
For the catalog search page, the field definitions for JSON format are as follows. Development only needs to follow the specifications.
The complete JSON format is as follows:
{
"//": "圖書館服務-書籍清單",
"data": [
{
"id": "lib-book-1",
"book_name": "我的第一本滑塊書 : 顏色配對",
"author": "Anton Poitier文 ; Maria Neradova圖",
"publisher": "新北市 :九童國際文化事業有限公司,[2016] ,©2016",
"publish_date": "2016/01/01",
"subject": "育兒 ; 親子遊戲",
"isbn": "9789864420780",
"thumbnail": "/images/library/IMG_2509.WEBP",
"click_count": 3450,
"call_number": "",
"series": [
{
"book_id": "lib-book-1",
"id": "lib-series-1",
"series＿name": "V. 1",
"waiting_people": 38,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-1",
"id": "lib-series-2",
"series＿name": "V. 2",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-1",
"id": "lib-series-3",
"series＿name": "V. 3",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-1",
"id": "lib-series-4",
"series＿name": "V. 4",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-1",
"id": "lib-series-5",
"series＿name": "V. 5",
"waiting_people": 0,
"is_reservation": true,
"is_hot": true
}
],
"libraries": [
{
"id": "lib-1",
"name": "BFB臺北市政府借書站(取書期限3日，無法申請請預約延長2日)",
"area": "信義區",
"address": {
"text": "臺北市信義區市府路1號",
"map": "https://maps.app.goo.gl/Xs8jEHqdEffssejv7"
},
"phone": "02-27552823",
"lat": "25.037491",
"lng": "121.564088",
"service_infos": [
{
"title": "依臺北市政府開放時間"
}
]
},
{
"id": "lib-2",
"name": "C21延吉",
"area": "大安區",
"address": {
"text": "臺北市大安區延吉街236巷17號3-4樓",
"map": "https://maps.app.goo.gl/CDc4f1i6N7cK53556"
},
"phone": "0227081964",
"lat": "25.036840205171266",
"lng": "121.55728022540654",
"service_infos": [
{
"title": "週二至週六",
"value": "8:30~21:00"
},
{
"title": "週日、週一",
"value": "9:00~17:00"
}
]
},
{
"id": "lib-3",
"name": "B12三興",
"area": "信義區",
"address": {
"text": "臺北市信義區吳興街156巷6號4、5樓",
"map": "https://maps.app.goo.gl/uRu7CSvHNjqJbMZo6"
},
"phone": "0287321063",
"lat": "25.029304444447725",
"lng": "121.56162172030848",
"service_infos": [
{
"title": "週二至週六",
"value": "8:30~21:00"
},
{
"title": "週日、週一",
"value": "9:00~17:00"
}
]
},
{
"id": "lib-4",
"name": "B11永春",
"area": "信義區",
"address": {
"text": "臺北市信義區松山路294號3樓",
"map": "https://maps.app.goo.gl/ahX62UDkFMiXy3xd8"
},
"phone": "0227609730",
"lat": "25.043701651787917",
"lng": "121.57899765603491",
"service_infos": [
{
"title": "週二至週六",
"value": "8:30~21:00"
},
{
"title": "週日、週一",
"value": "9:00~17:00"
}
]
},
{
"id": "lib-5",
"name": "CFB 信義安和借書站",
"area": "大安區",
"address": {
"text": "臺北市大安區信義路四段212-1號 B1",
"map": "https://maps.app.goo.gl/mjNuJN6BBez9Gjqq6"
},
"phone": "27552823-2104",
"lat": "25.03416873423933",
"lng": "121.55257274232868",
"service_infos": [
{
"title": "每日上午6時至晚間12時(依捷運站時間開放)"
}
]
},
{
"id": "lib-6",
"name": "B13六合",
"area": "信義區",
"address": {
"text": "臺北市信義區松仁路240巷19號3-5樓",
"map": "https://maps.app.goo.gl/18DFy7nNTbdYMVnZ7"
},
"phone": "0227292485",
"lat": "25.025116176981246",
"lng": "121.57040911000693",
"service_infos": [
{
"title": "週二至週六",
"value": "8:30~21:00"
},
{
"title": "週日、週一",
"value": "9:00~17:00"
}
]
}
]
},
{
"id": "lib-book-2",
"book_name": "說給兒童的臺灣歷史",
"author": "[天衛文化圖書製作] ; 林秋滿撰文",
"publisher": "臺北市 :天衛文化,2000g(2012印刷)",
"publish_date": "2012/01/01",
"subject": "歷史 ; 臺灣",
"isbn": "957490024X (第1冊 : 精裝) ; 9789574900244 (第1冊 : 精裝) ; 9789574900251 (第2冊 : 精裝) ; 9789574900268 (第3冊 : 精裝) ; 9789574900275 (第4冊 : 精裝) ; 9789574900282 (第5冊 : 精裝) ; 9789574900299 (第6冊 : 精裝) ; 9789574900305 (第7冊 : 精裝) ; 9789574900312 (第8冊 : 精裝) ; 9789574900329 (第9冊 : 精裝) ; 9789574900336 (第10冊 : 精裝)",
"thumbnail": "",
"click_count": 14829585,
"call_number": "733.2 1202",
"series": [
{
"book_id": "lib-book-2",
"id": "lib-series-1",
"series＿name": "V. 1(無附件可借)",
"waiting_people": 38,
"is_reservation": true,
"is_hot": true
},
{
"book_id": "lib-book-2",
"id": "lib-series-2",
"series＿name": "V. 1(有附件)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": true
},
{
"book_id": "lib-book-2",
"id": "lib-series-3",
"series＿name": "V. 2(無附件可借)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-2",
"id": "lib-series-4",
"series＿name": "V. 2(有附件)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-2",
"id": "lib-series-5",
"series＿name": "V. 3(無附件可借)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-2",
"id": "lib-series-6",
"series＿name": "V. 3(有附件)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-2",
"id": "lib-series-7",
"series＿name": "V. 4(無附件可借)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-2",
"id": "lib-series-8",
"series＿name": "V. 4(有附件)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-2",
"id": "lib-series-9",
"series＿name": "V. 5(無附件可借)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": false
},
{
"book_id": "lib-book-2",
"id": "lib-series-10",
"series＿name": "V. 5(有附件)",
"waiting_people": 0,
"is_reservation": true,
"is_hot": true
}
],
"libraries": [
{
"id": "lib-2",
"name": "C21延吉",
"area": "大安區",
"address": {
"text": "臺北市大安區延吉街236巷17號3-4樓",
"map": "https://maps.app.goo.gl/CDc4f1i6N7cK53556"
},
"phone": "0227081964",
"lat": "25.036840205171266",
"lng": "121.55728022540654",
"service_infos": [
{
"title": "週二至週六",
"value": "8:30~21:00"
},
{
"title": "週日、週一",
"value": "9:00~17:00"
}
]
}
]
},
// 以下省略...
]
}Data Field Description - Book List
| Field | Purpose | Example |
|---|---|---|
| id | Book ID | lib-book-1 |
| book_name | Book Name | My First Sliding Book: Color Matching |
| author | Author | Anton Poitier (Text); Maria Neradova (Illustrations) |
| publisher | Publisher | New Taipei City: Jiutong International Culture Enterprise Co., Ltd., [2016], ©2016 |
| publish_date | Publish Date | 2016/01/01 |
| subject | Subject | Parenting; Parent-Child Activities |
| isbn | ISBN | 9789864420780 |
| thumbnail | Book Thumbnail (Place image files in /public/images/library directory; leave empty for no image) | /images/library/IMG_2509.WEBP |
| click_count | Click Count | 3450 |
| call_number | Call Number | 733.2 1202 |
| series | Book Series | Refer to BookSeries |
| libraries | Pickup Libraries | Refer to Library |
BookSeries
| Field | Purpose | Example |
|---|---|---|
| book_id | Book ID | lib-book-1 |
| id | Series ID (Unique) | lib-series-1 |
| series_name | Series Name | V. 1 |
| waiting_people | Number of People Waiting | 38 |
| is_reservation | Reservation Availability (If false, reservation checkbox is disabled) | true/false |
| is_hot | Hot Collection Status (If true, "Hot Collection" label is displayed next to the series) | true/false |
Library
| Field | Purpose | Example |
|---|---|---|
| id | Pickup Library ID | lib-1 |
| name | Library Name | BFB Taipei City Government Book Pickup Station (Pickup deadline: 3 days, no reservation extension available) |
| area | Administrative District | Xinyi District |
| address | Address | See address table below |
| phone | Phone | 02-27552823 ext. 2104 |
| lat | Latitude | 25.037491 |
| lng | Longitude | 121.564088 |
| distance | Distance (Calculated automatically by frontend based on user's location and library location) | 10 |
| service_infos | Library Service Info (Multiple entries allowed) | Refer to ServiceInfo |
Address
| Field | Purpose | Example |
|---|---|---|
| text | Address Text | 2nd to 4th Floor, No. 47-12, Wanlong Street, Wenshan District, Taipei City |
| map | Address Google Map Link | https://maps.app.goo.gl/K93h62nMcAB4CWEN8 |
The Google Map link can be found through the sharing feature.
ServiceInfo
| Field | Purpose | Example |
|---|---|---|
| title | Title | Tuesday to Saturday |
| value | Content (Hidden if empty) | 8:30~21:00 |
API Design - Keyword Search - Popular Keywords
For popular keywords on the keyword search page, the field definitions for JSON format are as follows. Development only needs to follow the specifications.
The complete JSON format is as follows:
{
"//": "圖書館服務-關鍵字搜尋-熱門關鍵字",
"data": [
"神奇柑仔店",
"東野圭吾",
"小說",
"如果歷史是一群喵",
"X尋寶探險隊",
"857.7",
"漫畫",
"屁屁偵探",
"哈利波特",
"名偵探柯南"
]
}Field Description - Keyword Search - Popular Keywords
| Field | Purpose | Example |
|---|---|---|
| data | Popular keywords, pass as string | 神奇柑仔店 |
API Design - Important Information
For the important information page, the field definitions for JSON format are as follows. Development only needs to follow the specifications.
The complete JSON format is as follows:
{
"//": "圖書館服務-重要訊息",
"data": [
{
"id": "lib-notice-1",
"date": "2024/11/01",
"title": "太陽圖書館暫停對外服務",
"description": "",
"is_open_outer_link": true,
"outer_link": "https://tpml.gov.taipei/News_Content.aspx?n=E492D531630BC406&s=A2A01F99895FDED7&sms=78D644F2755ACCAA"
},
{
"id": "lib-notice-2",
"date": "2024/11/01",
"title": "113年「禮貌服務人員選拔」抽獎活動獲獎名單",
"description": "本館「禮貌服務人員選拔」業已辦理完竣，感謝讀者參與本次票選活動，本館隨機抽出50位投票者贈送100元超商禮券，獲獎名單如下：\n尤○萍、王○婷、白○麗、江○仁、吳○諦、宋○、李○柔、李○文、李○蘭、沈○慧、周○均、林○心、林○庭、林○盛、郎○淵、徐○宗、袁○濂、高○雯、梁○惠、許○怡、許○寧、許○芬、郭○旺、郭○慧、陳○金、陳○豪、陳○逸、游○娥、黃○丹、葉○初、葉○男、董○芬、鄒○達、劉○如、蔡○紋、鄭○勝、盧○洵、藍○豪、羅○元、嚴○仁、潘○衛、徐○鈞、林○玉、李○慧、黃○萍、吳○穗、藍○洲、陳○琳、王○英、沈○斌\n\n\n領獎說明：\n1、本館將主動以電話通知得獎民眾領獎。\n2、禮券將送至民眾指定之分館或民眾閱覽室，請得獎者逕至指定地點領取。\n3、請憑身分證、借閱證、健保卡或駕照於公告後60日內領取，且為利建檔登錄所得，應於領取時一併提供郵遞區號及戶籍地址，逾期未領視同放棄。",
"is_open_outer_link": false
},
{
"id": "lib-notice-3",
"date": "2024/10/28",
"title": "本館將於11月7日（星期四）休館日上午8時至下午8時進行資訊軟硬體設備更新維護作業，各服務系統偶有斷線或連線不穩情形",
"description": "本館將於11月7日（星期四）休館日上午8時至下午8時進行資訊軟硬體設備更新維護作業，當天各服務系統偶有斷線或連線不穩情形，另24小時智慧還書機、智慧圖書館及FastBook全自動借書站則以離線模式提供服務，若作業順利提早結束，將隨即恢復連線。造成不便，敬請見諒。",
"is_open_outer_link": false
},
{
"id": "lib-notice-4",
"date": "2024/03/21",
"title": "本館館藏查詢系統於深夜凌晨時間進行資料庫重整作業，期間偶有反應速度過慢情形",
"description": "本館館藏查詢系統為於白天尖峰時間提供較佳之效能，均會利用每日23:30-隔天06:30時段於不關主機狀態下進行資料庫重整作業，作業期間偶有伺服器主機資源負載過重情形，易出現館藏查詢系統及iRead APP反應速度過慢或選單未正常呈現等問題，如有類似情形發生，建議可將網頁重新整理數次或於白天使用。另本館將於今年下半年完成設備擴充作業，造成各位讀者不便，敬請見諒。",
"is_open_outer_link": false
},
{
"id": "lib-notice-5",
"date": "2024/01/23",
"title": "本館館藏查詢系統即日起開放Google、LINE登入服務",
"description": "本館館藏查詢系統即日起網頁版新增Google、LINE登入功能，綁定後可不輸入密碼透過第三方驗證登入。\n另從1月29日（星期一）起，密碼強制要求修改為長度至少8碼，須包含英文及數字之組合，以符合政府資安規範。若您使用預設密碼，強烈建議您提前完成變更，或事先申請綁定第三方驗證登入功能，以便利後續使用。",
"is_open_outer_link": false
},
{
"id": "lib-notice-6",
"date": "2023/07/01",
"title": "館藏查詢系統定期於每月休館日(第一個星期四)上午8時至10時進行維護",
"description": "本館館藏查詢系統定期於每月休館日(第一個星期四)上午8時至10時進行維護，期間無法連線館藏查詢系統，但其他服務維持運作，如 24小時智慧還書機、智慧圖書館及FastBook全自動借書站，待維護完成後立即恢復服務。造成不便，敬請見諒。",
"is_open_outer_link": false
},
{
"id": "lib-notice-7",
"date": "2022/05/03",
"title": "分館整修服務調整公告",
"description": "",
"is_open_outer_link": true,
"outer_link": "https://tpml.gov.taipei/News.aspx?n=E492D531630BC406&sms=78D644F2755ACCAA"
}
]
}Field Description - Important Information
| Field | Purpose | Example |
|---|---|---|
| id | Important Information ID | lib-notice-1 |
| date | Information Release Date | 2024/11/01 |
| title | Information Title | 太陽圖書館暫停對外服務 |
| description | Information Content. If is_open_outer_link is true, this field will be empty. | |
| is_open_outer_link | Whether to open in a new window | true/false |
| outer_link | External URL. If is_open_outer_link is true, this field is required. | https://tpml.gov.taipei/News_Content.aspx?n=E492D531630BC406&s=A2A01F99895FDED7&sms=78D644F2755ACCAA |