我的紀錄
/library-service?type=1
此頁面提供四項功能查詢：預約清單、預約未取紀錄、借閱中、借閱歷史紀錄。
預約清單
預約清單中顯示目前圖書借閱狀況。
- 可取書-顯示已完成相關程序，可至預約取書館取書的資料。
- 處理中-顯示已預約成功，且取書館已進入處理程序中的資料。
- 排序中-顯示已預約成功的書籍資料。
可取書
顯示書名、索書號、取書館、取書編號、取書期限，並提供延長兩日按鈕，僅限延長一次。 
點選延長 
延長成功 
延長成功後顯示「已延長兩日」，並且不能再次點選。 
處理中
顯示書名、索書號、取書館、調出日期。
處理中的書籍無法取消預約。 
排序中
顯示書名、索書號、取書館、預約排序，並提供取消預約按鈕，點選後取消本書籍預約。
點選取消預約後，預約書籍將從排序中移除。 
預約未取紀錄
顯示預約未取紀錄，欄位包括：書名、索書號、紀錄日期。
如無紀錄則顯示「目前沒有預約未取紀錄」。 
借閱中
顯示借閱中的書籍，欄位包括：書名、索書號、借閱日期、應還日期。
可申請續借，點選續借後導頁至圖書詳細頁，詳見圖書詳細，後續流程同預約書籍。
借閱歷史紀錄
顯示借閱歷史紀錄，欄位包括：書名、索書號、借閱日期(區間)。
可點選「由新到舊」或「由舊到新」排序。
資料呈現
API 設計-預約清單
關於預約清單頁面，JSON 格式的欄位定義如下，開發時只需遵照規格即可。
完整 JSON 格式如下
JSON
{
"//": "圖書館服務-預約清單",
"data": [
{
"name": "可取書",
"data": [
{
"id": "lib-book-1",
"record_id": "lib-book-1lib-series-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": "V. 1",
"selected_library": {
"id": "lib-2",
"name": "C21延吉",
"area": "大安區",
"address": {
"text": "臺北市大安區延吉街236巷17號3-4樓",
"map": "https://maps.app.goo.gl/CDc4f1i6N7cK53556"
},
"lat": 25.036840205171266,
"lng": 121.55728022540654
},
"status": "5",
"reservation_order": 1,
"extend_count": 0,
"reservation_date": "2024/08/27",
"processing_date": "2024/08/28",
"pickup_start_date": "2024/09/01",
"pickup_date": "",
"pickup_end_date": "2024/09/08",
"return_end_date": "",
"return_date": "",
"pickup_number": "080"
}
]
},
{
"name": "處理中",
"data": [
{
"id": "lib-book-5",
"record_id": "lib-book-5lib-series-1",
"book_name": "歡迎光臨錢天堂 : 神奇柑仔店大圖鑑",
"author": "廣嶋玲子文 ; jyajya圖 ; 王蘊潔譯",
"publisher": "台北市 :親子天下股份有限公司,2023",
"publish_date": "2023/01/01",
"subject": "兒童故事",
"isbn": "9786263055926",
"thumbnail": "/images/library/IMG_2629.JPG",
"click_count": 20400,
"call_number": "",
"selected_library": {
"id": "lib-1",
"name": "BFB臺北市政府借書站(取書期限3日，無法申請請預約延長2日)",
"area": "信義區",
"address": {
"text": "臺北市信義區市府路1號",
"map": "https://maps.app.goo.gl/Xs8jEHqdEffssejv7"
},
"lat": 25.037491,
"lng": 121.564088
},
"status": "3",
"reservation_order": 1,
"extend_count": 0,
"reservation_date": "2024/11/09",
"processing_date": "2024/11/10",
"pickup_start_date": "",
"pickup_date": "",
"pickup_end_date": "",
"return_end_date": "",
"return_date": "",
"pickup_number": ""
}
]
},
{
"name": "排序中",
"data": []
}
]
}API 設計-預約未取紀錄
關於預約未取紀錄頁面，JSON 格式的欄位定義如下，開發時只需遵照規格即可。
完整 JSON 格式如下
JSON
{
"//": "圖書館服務-預約未取紀錄",
"data": [
{
"id": "lib-book-1",
"record_id": "lib-book-1lib-series-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": "",
"selected_library": {
"id": "lib-2",
"name": "C21延吉",
"area": "大安區",
"address": {
"text": "臺北市大安區延吉街236巷17號3-4樓",
"map": "https://maps.app.goo.gl/CDc4f1i6N7cK53556"
},
"lat": 25.036840205171266,
"lng": 121.55728022540654
},
"status": "4",
"reservation_order": 1,
"extend_count": 0,
"reservation_date": "2024/08/27",
"processing_date": "2024/08/28",
"pickup_start_date": "2024/09/01",
"pickup_date": "",
"pickup_end_date": "2024/09/08",
"return_end_date": "",
"return_date": "",
"pickup_number": "080"
}
]
}API 設計-借閱中
關於借閱中頁面，JSON 格式的欄位定義如下，開發時只需遵照規格即可。
完整 JSON 格式如下
JSON
{
"//": "圖書館服務-借閱中",
"data": [
{
"id": "lib-book-1",
"record_id": "lib-book-1lib-series-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": "",
"selected_library": {
"id": "lib-2",
"name": "C21延吉",
"area": "大安區",
"address": {
"text": "臺北市大安區延吉街236巷17號3-4樓",
"map": "https://maps.app.goo.gl/CDc4f1i6N7cK53556"
},
"lat": 25.036840205171266,
"lng": 121.55728022540654
},
"status": "1",
"reservation_order": 1,
"extend_count": 0,
"reservation_date": "2024/08/27",
"processing_date": "2024/08/28",
"pickup_start_date": "2024/09/01",
"pickup_date": "2024/09/05",
"pickup_end_date": "2024/09/08",
"return_end_date": "2024/10/05",
"return_date": "",
"pickup_number": "080"
},
{
"id": "lib-book-5",
"record_id": "lib-book-5lib-series-1",
"book_name": "歡迎光臨錢天堂 : 神奇柑仔店大圖鑑",
"author": "廣嶋玲子文 ; jyajya圖 ; 王蘊潔譯",
"publisher": "台北市 :親子天下股份有限公司,2023",
"publish_date": "2023/01/01",
"subject": "兒童故事",
"isbn": "9786263055926",
"thumbnail": "/images/library/IMG_2629.JPG",
"click_count": 20400,
"call_number": "",
"selected_library": {
"id": "lib-1",
"name": "BFB臺北市政府借書站(取書期限3日，無法申請請預約延長2日)",
"area": "信義區",
"address": {
"text": "臺北市信義區市府路1號",
"map": "https://maps.app.goo.gl/Xs8jEHqdEffssejv7"
},
"lat": 25.037491,
"lng": 121.564088
},
"status": "1",
"reservation_order": 1,
"extend_count": 0,
"reservation_date": "2024/11/09",
"processing_date": "2024/11/10",
"pickup_start_date": "2024/11/11",
"pickup_date": "2024/11/13",
"pickup_end_date": "2024/11/18",
"return_end_date": "2024/12/13",
"return_date": "",
"pickup_number": "105"
}
]
}API 設計-借閱歷史紀錄
關於借閱歷史紀錄頁面，JSON 格式的欄位定義如下，開發時只需遵照規格即可。
完整 JSON 格式如下
JSON
{
"//": "圖書館服務-借閱歷史紀錄",
"data": [
{
"id": "lib-book-1",
"record_id": "lib-book-1lib-series-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": "",
"selected_library": {
"id": "lib-2",
"name": "C21延吉",
"area": "大安區",
"address": {
"text": "臺北市大安區延吉街236巷17號3-4樓",
"map": "https://maps.app.goo.gl/CDc4f1i6N7cK53556"
},
"lat": 25.036840205171266,
"lng": 121.55728022540654
},
"status": "6",
"reservation_order": 1,
"extend_count": 0,
"reservation_date": "2024/08/27",
"processing_date": "2024/08/28",
"pickup_start_date": "2024/09/01",
"pickup_date": "2024/09/05",
"pickup_end_date": "2024/09/08",
"return_end_date": "2024/10/05",
"return_date": "2024/10/01",
"pickup_number": "080"
},
{
"id": "lib-book-5",
"record_id": "lib-book-5lib-series-1",
"book_name": "歡迎光臨錢天堂 : 神奇柑仔店大圖鑑",
"author": "廣嶋玲子文 ; jyajya圖 ; 王蘊潔譯",
"publisher": "台北市 :親子天下股份有限公司,2023",
"publish_date": "2023/01/01",
"subject": "兒童故事",
"isbn": "9786263055926",
"thumbnail": "/images/library/IMG_2629.JPG",
"click_count": 20400,
"call_number": "",
"selected_library": {
"id": "lib-1",
"name": "BFB臺北市政府借書站(取書期限3日，無法申請請預約延長2日)",
"area": "信義區",
"address": {
"text": "臺北市信義區市府路1號",
"map": "https://maps.app.goo.gl/Xs8jEHqdEffssejv7"
},
"lat": 25.037491,
"lng": 121.564088
},
"status": "6",
"reservation_order": 1,
"extend_count": 0,
"reservation_date": "2024/11/09",
"processing_date": "2024/11/10",
"pickup_start_date": "2024/11/11",
"pickup_date": "2024/11/13",
"pickup_end_date": "2024/11/18",
"return_end_date": "2024/12/13",
"return_date": "2024/12/01",
"pickup_number": "105"
}
]
}資料欄位說明
第一層_data
| 欄位 | 用途 | 範例 |
|---|---|---|
| name | 項目名稱 | 可取書 |
| data | 該項目名稱的資料 | 參考第二層_data |
第二層_data
資料繼承書籍清單，參考資料欄位說明-書籍清單，並新增以下欄位：
| 欄位 | 用途 | 範例 |
|---|---|---|
| record_id | 紀錄 id，預約書籍時傳入(由書籍 id 與冊數 id 組成唯一值) | lib-book-1lib-series-1 |
| selected_library | 所選的取書館 object | 參考Library |
| status | 書籍狀態 | 5 (參考書籍狀態列舉表) |
| extend_count | 延長次數 | 0 |
| reservation_order | 預約排序，僅狀態為排序中時有值 | 39 |
| reservation_date | 預約日期 | 2024/08/27 |
| processing_date | 調出日期(處理中)或紀錄日期(預約未取)，狀態為處理中或預約未取時有值 | 2024/08/28 |
| pickup_start_date | 可取書日期，狀態為可取書時有值 | 2024/09/01 |
| pickup_date | 取書日期，狀態為借閱中時有值 | 2024/09/05 |
| pickup_end_date | 取書期限，狀態為可取書時有值 | 2024/09/08 |
| return_end_date | 應還日期，狀態為借閱中時有值 | 2024/10/05 |
| return_date | 還書日期，狀態為已還書時有值 | |
| pickup_number | 取書編號 | 080 |
書籍狀態列舉表
| 狀態 | 說明 |
|---|---|
| 0 | 可借 |
| 1 | 借閱中 |
| 2 | 已預約(排序中) |
| 3 | 處理中 |
| 4 | 預約未取 |
| 5 | 可取書 |
| 6 | 已還書 |