館藏查詢

/library-service?type=0

主頁

此頁面提供館藏關鍵字搜尋、新書介紹、點閱排行、重要訊息等服務。

館藏查詢

關鍵字搜尋

/library-service/keyword-search

輸入關鍵字、點選熱門關鍵字或點選最近搜尋，即可進行館藏查詢。

關鍵字搜尋

查詢到的圖書會顯示於下方，點選該書籍可導頁至該圖書的詳細介紹頁，詳見圖書詳細。

關鍵字搜尋-查有資料

查無資料時，顯示如下圖。

關鍵字搜尋-查無資料

點閱排行

預設顯示排行前五名，如下圖：關鍵字搜尋-點閱排行

點選更多，進入點閱排行列表頁，依照點閱次數由多至少排列，最多顯示100筆。

點選該書籍可導頁至該圖書的詳細介紹頁，詳見圖書詳細。關鍵字搜尋-點閱排行列表頁

重要訊息

預設顯示前三筆，如下圖：關鍵字搜尋-重要訊息

點選更多，進入重要訊息列表頁，依照發布順序由新至舊排列。

關鍵字搜尋-重要訊息

如資料設定為外連網站，則點選該訊息時會另開視窗，並連結至設定的網址;

如資料設定為訊息內容，則點選該訊息導頁至訊息的詳細頁，如下圖：關鍵字搜尋-重要訊息詳細頁

圖書詳細

/library-service/book-detail/:id

此頁顯示詳細的圖書內容，包含書籍圖片、書名、著者、出版項、主題、ISBN、預約等待人數等。下方顯示可預約的冊集，如為單冊則直接顯示如下圖：圖書詳細-單冊

如為多冊則依序顯示冊數並可直接勾選欲預約的集數：圖書詳細-多冊

選擇取書館

選擇好預約的冊數後，需要再選擇取書館，方能進行預約。

依距離選擇：選擇取書館-依距離選擇

依行政區選擇：選擇取書館-依行政區選擇

如預約成功，則會彈跳視窗顯示成功，並顯示本次預約成功書籍的筆數與取書館。

點選查看預約清單按鈕可至我的紀錄中查看，詳見我的紀錄。點選返回首頁按鈕，回到館藏查詢頁。選擇取書館-預約成功

如預約失敗，則彈跳視窗提示失敗原因。選擇取書館-預約失敗

一次預約上限為7筆，如超過冊數，跳提示如下：選擇取書館-超過預約冊數

注意

已預約的書籍無法重複預約。
如本次預約中有包含已預約過的書籍，則會自動跳過並僅預約尚未預約的書籍; 如本次預約皆為已預約之書籍，則會提示預約失敗訊息。
預約上限為7筆。

資料呈現

API 設計-書籍清單

關於館藏查詢頁面，JSON 格式的欄位定義如下，開發時只需遵照規格即可。
完整 JSON 格式如下

JSON

{
  "//": "圖書館服務-書籍清單",
  "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"
            }
          ]
        }
      ]
    },
    // 以下省略...
  ]
}

資料欄位說明-書籍清單

欄位	用途	範例
id	書籍 id	lib-book-1
book_name	書名	我的第一本滑塊書 : 顏色配對
author	著者	Anton Poitier文 ; Maria Neradova圖
publisher	出版項	新北市 :九童國際文化事業有限公司,[2016] ,©2016
publish_date	出版日期	2016/01/01
subject	主題	育兒 ; 親子遊戲
isbn	ISBN	9789864420780
thumbnail	書籍縮圖，將圖檔置於/public/images/library目錄下，如傳空值則無圖示	/images/library/IMG_2509.WEBP
click_count	點閱次數	3450
call_number	索書號	733.2 1202
series	書本集數	參考BookSeries
libraries	取書館	參考Library

BookSeries

欄位	用途	範例
book_id	書籍 id	lib-book-1
id	集數 id(唯一值)	lib-series-1
series_name	集數	V. 1
waiting_people	等待人數	38
is_reservation	是否開放預約，如填選 false，則勾選預約時 checkbox 反灰不能勾選	true/false
is_hot	是否為熱門館藏，如是，則在集數右邊顯示「熱門館藏」標籤	true/false

Library

欄位	用途	範例
id	取書館 id	lib-1
name	站點名稱	BFB臺北市政府借書站(取書期限3日，無法申請請預約延長2日)
area	行政區	信義區
address	地址	詳見下表 address
phone	電話	02-27552823轉2104
lat	經度	25.037491
lng	緯度	121.564088
distance	距離(前端根據目前位置與站點位置自動計算距離)	10
service_infos	取書館資訊，可多筆傳入	參考ServiceInfo

address

欄位	用途	範例
text	地址文字	臺北市文山區萬隆街47之12號2至4樓
map	地址 google map 連結	https://maps.app.goo.gl/K93h62nMcAB4CWEN8

google map 連結可以透過分享功能找到。

ServiceInfo

欄位	用途	範例
title	標題	週二至週六
value	內容，如無填寫則不顯示	8:30~21:00

API 設計-關鍵字搜尋-熱門關鍵字

關於關鍵字搜尋頁面的熱門關鍵字，JSON 格式的欄位定義如下，開發時只需遵照規格即可。
完整 JSON 格式如下

JSON

{
  "//": "圖書館服務-關鍵字搜尋-熱門關鍵字",
  "data": [
    "神奇柑仔店",
    "東野圭吾",
    "小說",
    "如果歷史是一群喵",
    "X尋寶探險隊",
    "857.7",
    "漫畫",
    "屁屁偵探",
    "哈利波特",
    "名偵探柯南"
  ]
}

資料欄位說明-關鍵字搜尋-熱門關鍵字

欄位	用途	範例
data	熱門關鍵字，傳入 string 即可	神奇柑仔店

API 設計-重要訊息

關於重要訊息頁面，JSON 格式的欄位定義如下，開發時只需遵照規格即可。
完整 JSON 格式如下

JSON

{
  "//": "圖書館服務-重要訊息",
  "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"
    }
  ]
}

資料欄位說明-重要訊息

欄位	用途	範例
id	重要訊息 id	lib-notice-1
date	訊息發佈日期	2024/11/01
title	訊息標題	太陽圖書館暫停對外服務
description	訊息內容，如 is_open_outer_link 為 true，則內容為空
is_open_outer_link	是否為另開視窗	true/false
outer_link	外連 url，如 is_open_outer_link 為 true，此欄位為必填	https://tpml.gov.taipei/News_Content.aspx?n=E492D531630BC406&s=A2A01F99895FDED7&sms=78D644F2755ACCAA

用戶介面

用戶介面

用戶介面

用戶介面

雙向溝通 App

館藏查詢 ​

/library-service?type=0 ​

主頁 ​

關鍵字搜尋 ​

/library-service/keyword-search ​

點閱排行 ​

重要訊息 ​

圖書詳細 ​

/library-service/book-detail/:id ​

選擇取書館 ​

資料呈現 ​

API 設計-書籍清單 ​

資料欄位說明-書籍清單 ​

BookSeries ​

Library ​

address ​

ServiceInfo ​

API 設計-關鍵字搜尋-熱門關鍵字 ​

資料欄位說明-關鍵字搜尋-熱門關鍵字 ​

API 設計-重要訊息 ​

資料欄位說明-重要訊息 ​

館藏查詢

/library-service?type=0

主頁

關鍵字搜尋

/library-service/keyword-search

點閱排行

重要訊息

圖書詳細

/library-service/book-detail/:id

選擇取書館

資料呈現

API 設計-書籍清單

資料欄位說明-書籍清單

BookSeries

Library

address

ServiceInfo

API 設計-關鍵字搜尋-熱門關鍵字

資料欄位說明-關鍵字搜尋-熱門關鍵字

API 設計-重要訊息

資料欄位說明-重要訊息