My Records
/library-service?type=1
This page provides four query functions: Reservation List, Unclaimed Reservations, Currently Borrowed, and Borrowing History.
Reservation List
The reservation list displays the current status of library book borrowing.
- Available for Pickup - Shows books that have completed the necessary procedures and are ready for pickup at the designated library.
- Processing - Shows books that have been successfully reserved and are currently being processed by the library.
- In Queue - Shows books that have been successfully reserved but are still waiting to be processed.
Available for Pickup
Displays the book name, call number, pickup library, pickup ID, and pickup deadline.
Includes an "Extend by 2 Days" button, which can only be used once.
Click "Extend": 
Extension Successful: 
After a successful extension, "Extended by 2 Days" will be displayed, and the button will be disabled: 
Processing
Displays the book name, call number, pickup library, and dispatch date.
Books in the "Processing" status cannot be canceled.
In Queue
Displays the book name, call number, pickup library, and reservation queue number.
Includes a "Cancel Reservation" button that removes the book from the queue when clicked.
After canceling a reservation, the book is removed from the queue: 
Unclaimed Reservation Records
Display unclaimed reservation records with the following fields: Title, Call Number, and Record Date.
If there are no records, display the message: "No unclaimed reservation records at the moment." 
Currently Borrowed
Displays books currently being borrowed, with fields including book name, call number, borrowing date, and due date.
Users can apply for a renewal by clicking "Renew," which navigates to the book detail page. For details, see Book Details. The subsequent process follows the same steps as book reservations.
Borrowing History
Displays borrowing history, with fields including book name, call number, and borrowing date (range).
Users can sort by "Newest to Oldest" or "Oldest to Newest."
Data Display
API Design - Reservation List
For the reservation list 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": [
{
"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 Design - Unclaimed Reservation Records
For the unclaimed reservation records page, the JSON field definitions are as follows. Developers should adhere to the specification during implementation.
The complete JSON format is shown below:
{
"//": "圖書館服務-預約未取紀錄",
"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 Design - Currently Borrowed
For the "Currently Borrowed" 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",
"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 Design - Borrowing History
For the "Borrowing History" 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",
"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"
}
]
}Field Description
First Level: _data
| Field | Purpose | Example |
|---|---|---|
| name | Item name | Available for Pickup |
| data | Data for the item name | Refer to Second Level: _data |
Second Level: _data
The data inherits from the book list. Refer to Field Description - Book List, and includes the following additional fields:
| Field | Purpose | Example |
|---|---|---|
| record_id | Record ID. Passed when reserving books (unique value formed by combining book ID and series ID) | lib-book-1lib-series-1 |
| selected_library | Selected pickup library object | Refer to Library |
| status | Book status | 5 (Refer to Book Status Enumeration) |
| extend_count | Extension count | 0 |
| reservation_order | Reservation order, only available when the status is "In Queue" | 39 |
| reservation_date | Reservation date | 2024/08/27 |
| processing_date | The processing date (for "In Process") or the record date (for "Unclaimed Reservation"). This field has a value when the status is either "In Process" or "Unclaimed Reservation". | 2024/08/28 |
| pickup_start_date | Available for pickup date, available when the status is "Available for Pickup" | 2024/09/01 |
| pickup_date | Pickup date, available when the status is "Currently Borrowed" | 2024/09/05 |
| pickup_end_date | Pickup deadline, available when the status is "Available for Pickup" | 2024/09/08 |
| return_end_date | Due date, available when the status is "Currently Borrowed" | 2024/10/05 |
| return_date | Return date, available when the status is "Returned" | |
| pickup_number | Pickup number | 080 |
Book Status Enumeration
| Status | Description |
|---|---|
| 0 | Available |
| 1 | Currently Borrowed |
| 2 | Reserved (In Queue) |
| 3 | Processing |
| 4 | Unclaimed |
| 5 | Available for Pickup |
| 6 | Returned |