API 索引

User 認證帳號密碼
User 取得個人資料
館藏查詢
對館藏查詢傳回的 setno 排序
館藏查詢取回查詢結果
館藏查詢取回多筆館藏狀態
館藏查詢取回單筆書目詳細資料
館藏查詢取回單筆書目的館藏狀態
館藏查詢取回特定 User 對單筆書目的館藏狀態的權限
User 對單筆書目的館藏狀態資料預約
User 用 Rest Api 對單筆書目的館藏狀態資料預約
User 對單筆書目的館藏取消先前的預約
User 對單筆書目的館藏借閱延長期限
查尋FindBook 或是 GoogleBook 館藏資料
將手機的 device token，userid ，及對應的 OS 類型存回 server
User Android GCM 測試
查詢當下 iOS 的最新版本
查詢當下 Android 的最新版本
百度憑證網址
新增薦購API
隱私權政策
隱私權政策_英文
目前有開啟推播的作業系統/人數
每個月/作業系統初次安裝登入的人數
熱門借閱
熱門預約
熱門新書
廣告信開關設定-帳號_狀態(NO_YES)
薦購歷史清單(JAVA版)
取得書車目錄
取得書車目錄下的書目
刪除書車下的書目或書車目錄與下面的資料
加入書車-新增資料夾
加入書車-加到現有目錄
取得薦購資料類型
新增薦購(JAVA版)
取得讀者簽署資料
簽署新增(JAVA版)
開閉館時間
開閉館時間 +熱門借閱、熱門預約、熱門新書-合集
取得推播清單
更新推播訊息已讀
推播訊息-廣播用
推播訊息-廣播用-有推播明細(可限定條件)

Server 啟動執行方式

目前提供的是 Linux x86 64 位元執行檔，如果需要 window ，mac ，或是 32 位元的執行程式請洽 terryh.tp at gmail.com

可以下指令參數的方式看程式說明，說明的參數是 -h，在 Linux 命令列下輸入 ./alephapi -h ，就可以看到程式執行說明，預設服務會開啟服務在 http port 22222


terry@MacBookAir ~/tmp $ ./alephapi -h
age of tmp/runner-build:
  -BASE="TOP02": Please spefic the base , Default is: TOP02

  -FINDBASE="": Please spefic the findbase , Default is empty string

  -InitMsg=false: If you would like active the Android GCM and iOS APN server
	you must initiate the user db fisrt, this will create the user.db under the "msg" folder

  -LIBRARY="TOP51": Please specific the library  , Default is: top51

  -LISTEN=":22222": Please spefic the ip address for listen , Default is: ":22222"
    mean listen on 0.0.0.0:22222


  -REST="http://127.0.0.1:1891": Please spefic the Rest Server URL, this is required for Person service to booking items
	Default: http://127.0.0.1:1891

  -X="http://127.0.0.1/X": Please spefic the X Server URL, Default: http://127.0.0.1/X
  
  -RAMS="http://127.0.0.1:8088/RAMS2013":Please spefic the RAMS URL, Default: http://127.0.0.1:8088/RAMS

參數說明

-X 請填 aleph X server 的 URL，例 -X="http://aleph.lib.ncnu.edu.tw/X" 預設是 http://127.0.0.1/X

-REST 請填 aleph REST server 的 URL ，預設是 http://127.0.0.1:1891

-BASE 請填 aleph base 的值，一般是 TOP01 或是 TOP02, -BASE="TOP01" 或是 -BASE="TOP02" 系統預設值是用 TOP02

-FINDBASE 請填 aleph findbase 的值，系統預設值是空值

-LIBRARY 請填 aleph library 的值，系統預設 top51

-LISTEN 這一個 api 服務要運行的 http port 位置，預設是 :22222 就是這一台機器的 0.0.0.0:22222
例如只要在 IP 1.2.3.4 的 8888 port 服務 -LISTEN="1.2.3.4:8888"
要在這一台機器所有 IP 的 8080 port -LISTEN=":8080"

目前預設是 X server 及 Rest server 的網址都是 localhost (127.0.0.1) ，請執行時，依實際情形設置

例如:
目前如果要對應的 X server 位置是 http://aleph.lib.ntu.edu.tw/X

Rest server 位置是 http://aleph.lib.ntu.edu.tw:1891

如果 BASE 沒有變動，也是 TOP02
LIBRARY 是 top51 如果其他參數有異動，可下參數蓋過預設的參數。

如下：


terry@MacBookAir ~/tmp $ ./alephapi -REST="http://aleph.lib.ntu.edu.tw:1891" -X="http://aleph.lib.ntu.edu.tw/X"
alephapi 0.0.1 is running, listen on :22222
talk to Xserver  http://aleph.lib.ntu.edu.tw/X Rest server http://aleph.lib.ntu.edu.tw:1891
in BASE=> TOP02 LIBRARY=> top51

以下為 API 說明，目前全部都是用 HTTP 的協定

GET

必須使用Get 方式的服務

POST

必須使用Post 方式的服務

DELETE

必須使用 DELETE 方式的服務

PARAMS

代表 POST，PUT，或是 DELETE 需要夾帶的參數名稱，"Content-Type", "application/x-www-form-urlencoded"

:URL參數

代表 URL 裡面的路徑所代表的參數

語言

URL /api/第一個位置語言 , 目前只有 chi 或是 eng

POST AUTH

http://localhost:22222/api/chi/auth?userid=&password=

用來認證，使用者的帳號密碼

PARAMS: userid, password

Example:

使用者證號 1234 密碼 1234


terry@MacBookAir ~ $ curl -X POST  "http://localhost:22222/api/chi/auth?userid=1234&password=1234"
{
    "id": "1234",
    "name": "FlySheet-飛資得堃",
    "email": "1234@flysheet.com.tw",
    "expire": "20180124"
}

GET INFO

http://localhost:22222/api/chi/info/:userid

用來讀取使用者的帳號資料，資料內的 "bookings" 為預約清單，"fines" 為罰款資料，"rents" 為目前借閱的清單，目前這一個服務，若是要擋權限，可以在您讀取這一個資料之前，可先要求使用者登入

Example:

使用者證號 9090


terry@MacBookAir ~ $ curl -X GET  "http://localhost:22222/api/chi/info/9090"

{
    "id": "9090",
    "name": "FlySheet-飛資得",
    "email": "sen@flysheet.com.tw",
    "expire": "20180827",
    "type": "土木工程學系",
    "status": "大學生",
    "rents": [
        {
            "duedate": "20140704",
            "currentfine": "      200.00",
            "docnumber": "005459718",
            "title": "測試期刊.",
            "author": "",
            "isbn": "1017-4265",
            "callno": "",
            "barcode": "5459718-530",
            "material": "期刊",
            "sublibrary": "圖書館",
            "collection": "3F",
            "renewal": "0"
        },
        {
            "duedate": "20140930",
            "currentfine": "",
            "docnumber": "005439765",
            "title": "56%飛資得測試.",
            "author": "權威作者地new.",
            "isbn": "1111111111111",
            "callno": "HN65 D995 2011",
            "barcode": "5439765-20",
            "material": "圖書",
            "sublibrary": "圖書館",
            "collection": "5F 中文圖書區",
            "renewal": "2"
        }
    ],
    "bookings": [
        {
            "duedate": "",
            "currentfine": "",
            "docnumber": "005439765",
            "title": "56%飛資得測試.",
            "author": "權威作者地new.",
            "isbn": "1111111111111",
            "callno": "HN65 D995 2011",
            "barcode": "B1CSS0001",
            "material": "圖書",
            "sublibrary": "密集書庫",
            "collection": "B1調閱密集書庫圖書",
            "sequence": "0001",
            "itemsequence": "000100",
            "opendate": "20140619",
            "expand": "N",
            "location": "圖書館",
            "requesttype": "H"
        }
    ],
    "fines": [
        {
            "duedate": "",
            "currentfine": "",
            "docnumber": "",
            "title": "",
            "author": "",
            "isbn": "",
            "callno": "",
            "barcode": "",
            "material": "",
            "sublibrary": "",
            "collection": "",
            "status": "Paid",
            "date": "20131031",
            "netsum": "120.00"
        },
        {
            "duedate": "",
            "currentfine": "",
            "docnumber": "",
            "title": "",
            "author": "",
            "isbn": "",
            "callno": "",
            "barcode": "",
            "material": "",
            "sublibrary": "",
            "collection": "",
            "status": "Paid",
            "date": "20131031",
            "netsum": "50.00"
        },
        {
            "duedate": "",
            "currentfine": "",
            "docnumber": "",
            "title": "",
            "author": "",
            "isbn": "",
            "callno": "",
            "barcode": "",
            "material": "",
            "sublibrary": "",
            "collection": "",
            "status": "Paid",
            "date": "20140207",
            "netsum": "12.00"
        },
        {
            "duedate": "",
            "currentfine": "",
            "docnumber": "5439765",
            "title": "56%飛資得測試.",
            "author": "權威作者地new.",
            "isbn": "1111111111111",
            "callno": "HN65 D995 2011",
            "barcode": "X888888",
            "material": "圖書",
            "sublibrary": "圖書館",
            "collection": "4F 中文圖書區",
            "status": "Cancelled",
            "date": "20140626",
            "netsum": "15.00"
        }
    ]
}

GET FIND

http://localhost:22222/api/chi/find/:base/:keyword

檢索館藏資料，傳回值中，setno 代表這一次查詢的結果序號，records 為有結果的筆數，entries 是實際最大可取回的筆數，目前最大結果10000 筆，最大單次取回筆數 100 筆 , base 的值，一般為 TOP01 或是 TOP02 ，會於專案開始時決定

一般查詢也支援 Aleph 的欄位查詢，就是像下面的範例，全文查詢 TOP02 "九把刀" 要改成查書刊名 "九把刀"，可以把查詢的網址改為

http://localhost:22222/api/chi/find/TOP02/WTL=九把刀

目前一般 Aleph 的查詢欄位對應

WRD 關鍵字
WTL 書刊名關鍵字
WSR 叢書名關鍵字
WAU 作者關鍵字
WPU 出版者關鍵字
WSH 標題關鍵字
ISBN ISBN
ISSN ISSN
ISRC ISRC
ASHL 索書號
BAR 登錄號
SYS 書目系統號

Example:

查詢九把刀


terry@MacBookAir ~ $ curl -X GET http://localhost:22222/api/chi/find/TOP02/九把刀
{
    "setno": "000605",
    "records": "000000035",
    "entries": "000000035"
}

GET SORT

http://localhost:22222/api/sort/:base/:setno/:sort1/:sort2

檢索館藏資料，傳回值中，會有 setno 代表這一次查詢的結果序號，這一個 Api 請求，可以改變這一個查詢結果序號的排序 , base 的值，就是同您查詢時的 base 值，一般為 TOP01 或是 TOP02，sort1 就是第一個要排序的欄位，預設是升冪，如過要降冪排列，請在 sort1 前面加-，(就是加一個負號的意思，就是降冪了)

就是像下面的範例，對 base TOP02， setno 002209 ，欄位 01 降冪排序

http://localhost:22222/api/sort/TOP02/002209/-01

Example:


terry@MacBookAir ~ $ curl -X GET http://localhost:22222/api/sort/TOP02/002209/-01
{
   "status": "OK"
}

GET FETCH

http://localhost:22222/api/chi/fetch/:setno/:start/:end

取回查詢結果，其中 setno 就是使用查詢服務回傳的查詢結果序號， start 及 end 就是要取回結果 entries 的範圍，區間最大為 100，例如要得到第1 到第 20 筆的資料 start 就是 1，end 就是 20

Example:

要取回查詢結果序號 000605 起始筆數順序1，結束筆數順序號2


terry@MacBookAir ~ $ curl -X GET  http://localhost:22222/api/chi/fetch/000605/1/2
[
    {
        "authors": [
            "九把刀"
        ],
        "docnumber": "005449881",
        "format": "BK",
        "isbn": "9789867494719",
        "lg": "chi",
        "publish": "臺北縣五股鄉 : 凌域國際公司總經銷, 2005.",
        "title": [
            "殺手 :登峰造極的畫 = Killer /"
        ],
        "version": "初版"
    },
    {
        "authors": [
            "九把刀"
        ],
        "docnumber": "005439872",
        "format": "BK",
        "isbn": "9789863190530",
        "lg": "chi",
        "publish": "臺北市 : 蓋亞文化, 2013.",
        "title": [
            "哈棒傳奇之繼續哈棒 /"
        ],
        "version": "初版"
    }
]

POST STATUS

取回館藏資料的館藏狀態，X server 的文件上面說，上限最多只可查詢 10 筆資料，個人不專業測試可以超過沒問題，最多可以查到 50 筆，送出的參數名稱是 docnumbers，多筆資料時，將每一個系統號用半型逗點，相連成一字串，傳回值 status 是館藏狀態 available 是"有可用館藏" unavailable "館藏已外借或不在架上"， outside 是外借數量，stock 是館藏數量

http://localhost:22222/api/chi/status

PARAMS: docnumbers

Example:

要查詢館藏資料號碼系統號( docnumber) 為 005449881 及 005439872 的館藏狀態


terry@MacBookAir ~ $ curl -X POST "http://localhost:22222/api/chi/status?docnumbers=005449881,005439872"
[
    {
        "docnumber": "005449881",
        "outside": "0",
        "status": "available",
        "stock": "1"
    },
    {
        "docnumber": "005439872",
        "outside": "1",
        "status": "unavailable",
        "stock": "1"
    }
]

GET DETAIL

取回單筆館藏資料, URL 參數就是館藏資料的 docnumber (系統號)

http://localhost:22222/api/chi/detail/:docnumber

Example:

要查詢單筆館藏 docnumber 為 005325437


terry@MacBookAir ~ $ curl -X GET "http://localhost:22222/api/chi/detail/005325437"
{
    "authors": [
        "九把刀"
    ],
    "docnumber": "005325437",
    "format": "BK",
    "isbn": "9789866345340",
    "lg": "chi",
    "publish": "臺北市 : 春天出版國際, 2010",
    "title": [
        "精準の失控 =Precisely out of control /"
    ],
    "version": "初版"
}

GET ITEMS

取回單筆館藏書目資料館藏的所有情形, URL 參數就是館藏資料的 docnumber (系統號)

http://localhost:22222/api/chi/detail/:docnumber/items

Example:

要查詢單筆館藏 docnumber 為 005325437，的所有館藏資料


terry@MacBookAir ~ $ curl -X GET "http://localhost:22222/api/chi/detail/005325437/items"
[
    {
        "reckey": "005325437000010",
        "barcode": "C246544",
        "sublibrary": "圖書館",
        "collection": "5FCB",
        "description": "",
        "itemstatus": "00",
        "callno": "$$h857.7$$i8656:3-7",
        "onhold": "N",
        "load_duedate": "20140514",
        "requested": "N"
    },
    {
        "reckey": "005325437000020",
        "barcode": "C252059",
        "sublibrary": "圖書館",
        "collection": "5FCB",
        "description": "",
        "itemstatus": "00",
        "callno": "$$h857.7$$i8656:3-7$$2c.2",
        "onhold": "N",
        "load_duedate": "",
        "requested": "N"
    }
]

POST ITEMS

取回特定 User 對單筆館藏書目資料館藏的所有情形, URL 參數就是館藏資料的 docnumber (系統號), 傳回值裡的 bookable ，就是這一個 userid 能否預約

http://localhost:22222/api/chi/detail/:docnumber/items

PARAMS: userid

Example:

要查詢單筆館藏 docnumber 為 005325437，相對 userid 1234 的所有館藏資料，和可否預約


terry@MacBookAir ~ $ curl -X POST "http://localhost:22222/api/chi/detail/005325437/items?userid=1234"
[
    {
        "reckey": "005325437000010",
        "barcode": "C246544",
        "sublibrary": "圖書館",
        "collection": "5FCB",
        "description": "",
        "itemstatus": "00",
        "callno": "$$h857.7$$i8656:3-7",
        "onhold": "N",
        "load_duedate": "20140528",
        "requested": "Y",
        "bookable": "Y"
    },
    {
        "reckey": "005325437000020",
        "barcode": "C252059",
        "sublibrary": "圖書館",
        "collection": "5FCB",
        "description": "",
        "itemstatus": "00",
        "callno": "$$h857.7$$i8656:3-7$$2c.2",
        "onhold": "N",
        "load_duedate": "",
        "requested": "N",
        "bookable": "N"
    }
]

POST BOOK

如果單筆館藏的資料的每一個清單資料裡如果 bookable 為 "Y", 即可以用預約

http://localhost:22222/api/chi/person/book

PARAMS: userid, barcode

Example:

userid 1234 預約 barcode 為 C246544 的館藏


terry@MacBookAir ~ $ curl -X POST "http://localhost:22222/api/chi/person/book?userid=1234&barcode=C246544"
{
    "status": "OK"
}

POST RESTBOOK

如果單筆館藏的資料的每一個清單資料裡如果 bookable 為 "Y", 即可以用預約

http://localhost:22222/api/chi/person/restbook

PARAMS: userid, docnumber, reckey, location

Example:

userid 1234 預約 docnumber 為 005239820, reckey 005239820000010, location NCNUL 的館藏


terry@MacBookAir ~ $ curl -X POST "http://localhost:22222/api/chi/person/book?userid=1234&docnumber=005239820&reckey=005239820000010&location=NCNUL"
{
    "status": "OK"
}

POST CANCEL

取消特定 userid 目前的預約記錄 bookable

http://localhost:22222/api/chi/person/cancel

PARAMS: docnumber, itemsequence, sequence

Example:

取消 docnumber 005325437, itemsequence 000010 , sequence 0010 的預約


terry@MacBookAir ~ $ curl -X POST "http://localhost:22222/api/chi/person/cancel?docnumber=005325437&itemsequence=000010&sequence=0010"
{
    "status": "OK"
}

POST EXTEND

對目前外借的館藏做延期的動作

http://localhost:22222/api/chi/person/extend

PARAMS: userid, barcode

Example:

userid 1234 要延期 barcode 為 8888 的館藏, 成功的話，會傳回 status: "OK", 及 due: "到期的日期"


terry@MacBookAir ~ $ curl -X POST "http://localhost:22222/api/chi/person/extend?userid=1234&barcode=8888"
{
    "status": "Patron has 1 overdue items in the item sublibrary."
}

GET QUERY

查尋FindBook 或是 GoogleBook 館藏資料

http://localhost:22222/api/query/:isbn

Example:

查詢 ISBN 為 9789865912604 的書籍資料


terry@MacBookAir ~ $ curl -X GET "http://localhost:22222/api/query/9789865912604"

{
    "title": "BIG DATA：讓你看見真實欲望",
    "author": "宋吉永",
    "isbn": "9789865912604",
    "Publisher": "悅知文化",
    "pubdate": "2013-08-19",
    "pubdate": "2013-08-19",
    "cover": "http://cft.findbook.tw/image/book/9789865912604/large",
    "refurl": "http://findbook.tw/book/9789865912604/basic",
    "intro": "你或許知道，BIG DATA正在快速改變我們的生活形態，更應該知道，如何透過BIG DATA改變顧客的消費行為。你曾經再熟悉不過的市場分析、行銷方式、銷售手段已經成為過去。巨量資料的時代已經來臨，你值得用更有效率的方式來得到顧客的焦慮、問題、需求是什麼，用更精準的資料來做為商業決策的依據。這是一項值得你花時間去瞭解的投資，用最科學、最客觀的資料分析，挖掘出顧客的真實欲望，擷取出需求的真實樣貌，在欲望、需求浮出檯面之前，成功取得市場先機。BIG DATA為什麼精準？客觀｜樣本數不再是隨機抽樣，而是全體真實｜答案不是刻意營造也非選擇題，而是日常反應即時｜網路資料無時無刻在汰舊換新當中巨量資料釋放了精準行銷的無限潛力，徹底揭露消費者行為的神秘面紗，讓商業決策得以革新，預見未來的軌跡。從事市場工作的你，準備好了嗎？* 星巴克的競爭對手不是咖啡館？* 打敗頂級保養品的是醫美診所？* 精品的成功秘訣在於限量供應？* 如何準確挑選品牌代言人？巨量資料足以取代所有傳統調查及預測工具，它的精準前所未見。雖名為巨量，但重點並非在於數量或大小，而是在於它的深度及廣度。別忘了，巨量資料只是工具，你該學習的，是如何活用它。"
}

POST DEVICE

將手機的 device token，userid ，subscribe，及對應的 OS 類型存回 server，device 代表 Google GCM ，或是 Apple APN 給的 device token， os 目前只有分 Android 或是 iOS，只要不是 android 的，就會被歸到 iOS，subscribe 是否訂閱推播，只要有值，不管是 true 或是1，任何值，就為 True，空值代表 False

新增寫入讀者表，加上讀者辦證館別、讀者狀態、讀者單位-推播限制用這邊需要再抓一次讀者資料 http://webpac.lib.ccu.edu.tw:8888/api/eng/info/9090 lang需要使用eng，這樣子才有辦法回傳代碼 /api/eng/info/9090 說明帶入參數 hlibrary 讀者辦證館別 home_library status 讀者狀態 bor_status type 讀者單位 bor_type

http://localhost:22222/api/device

PARAMS: userid, device, os, subscribe

Example:

userid 9090，deivce token AAAA，os Android ，subscribe 1


terry@MacBookAir ~ $ curl -X POST "http://localhost:22222/api/device?userid=9090&device=AAAA&os=Android&subscribe=1"
{"status":"OK"}

Example推播限制用:

userid 9090，deivce token AAAA，os Android ，subscribe 1 ,home_library MA,bor_status 13,bor_type AN


terry@MacBookAir ~ $ curl -X POST "http://webpac.lib.ccu.edu.tw:8888/api/device?userid=9090&device=AAAA&os=Android&subscribe=1&home_library=MA&bor_status=13&bor_type=AN"
{"status":"OK"}

POST MSG

http://localhost:22222/api/msg?userid=&title=&content=&number=

User Android GCM 測試

PARAMS: userid, title, content, number

Example:

使用者證號 1234 標題 Hello 內容我是測試 number 2


terry@MacBookAir ~ $ curl -X POST  "http://localhost:22222/api/msg?userid=1234&title=Hello&content=我是測試&number=2"
{"status":"OK"}

GET Version iOS

http://localhost:22222/api/version/ios

用來抓取 iOS 目前的最新版本，會讀取 ./ios.json 檔案，傳回內容

Example:


terry@MacBookAir ~ $ curl -X GET  "http://localhost:22222/api/version/ios"
{
    "version": "1.0",
    "url": "http://www.google.com",
    "intro": "Hello World 我是更新"
}

GET Version Android

http://localhost:22222/api/version/android

用來抓取 Android 目前的最新版本，會讀取 ./android.json 檔案，傳回內容

Example:


terry@MacBookAir ~ $ curl -X GET  "http://localhost:22222/api/version/android"
{
    "version": "1.0",
    "url": "http://www.google.com",
    "intro": "Hello World 我是更新"
}

百度憑認申請時綁定的網址

https://localhost/.well-known/pki-validation/fileauth.htm

http://localhost/.well-known/pki-validation/fileauth.htm

用來抓取本機在百度申請的檔案fileauth.htm，會讀取 ./fileauth.htm或是 /exlibris/aleph/u22_1/alephe/apache/htdocs/.well-known/pki-validation/fileauth.htm 檔案，傳回內容

Example:


terry@MacBookAir ~ $ curl -X GET  "https://localhost:22222/.well-known/pki-validation/fileauth.htm"
{
    201703061501005ojwb6hdj2xeng6xbau0jmudxv0frpv62i0p36b3kdfhb87sf8
}

新增薦購API

https://localhost/RAMS?xID=9090&xPW=&xTi=書名&xAu=作者&xISBN=ISBNX&xPublisher=出版者&xPubYear=出版年

新增薦購API，傳回新增結果，這邊需要設定薦購的網址。在啟動API需需要加上 -RAMS=http://127.0.0.1:8088/RAMS2013

Example:


terry@MacBookAir ~ $ curl -X GET  "https://localhost/RAMS?xID=9090&xPW=&xTi=書名&xAu=作者&xISBN=ISBNX&xPublisher=出版者&xPubYear=出版年"
{
  "Error": "",
  "Reply": "OK"
}

GET Version Policy

http://localhost:22222/api/version/android

用來抓取隱私權政策，會讀取 ./policy.htm 檔案，傳回內容

Example:


terry@MacBookAir ~ $ curl -X GET  "http://localhost:22222/api/version/policy"
{
隱私權政策內容
}

GET Version Policy Eng

http://localhost:22222/api/version/policy_eng

用來抓取隱私權政策，會讀取 ./policy_eng.htm 檔案，傳回內容

Example:


terry@MacBookAir ~ $ curl -X GET  "http://localhost:22222/api/version/policy_eng"
{
隱私權政策內容
}

每個月/作業系統初次安裝登入的人數

http://localhost:22222/rpt/OsCount

用來抓取每個月/作業系統初次安裝登入的人數，傳回內容

Example:


terry@MacBookAir ~ $ curl -X GET  "http://localhost:22222/rpt/OsCount"
{
[{"Created":"2016-09","Os":"Android","cnt":2},{"Created":"2016-09","Os":"iOS","cnt":1},{"Created":"2016-10","Os":"Android","cnt":4},{"Created":"2016-11","Os":"Android","cnt":1},{"Created":"2016-12","Os":"Android","cnt":2},{"Created":"2017-01","Os":"Android","cnt":5},{"Created":"2017-01","Os":"iOS","cnt":2},{"Created":"2017-02","Os":"Android","cnt":3},{"Created":"2017-02","Os":"iOS","cnt":4},{"Created":"2017-03","Os":"Android","cnt":5},{"Created":"2017-03","Os":"iOS","cnt":4},{"Created":"2017-04","Os":"Android","cnt":28},{"Created":"2017-04","Os":"iOS","cnt":8},{"Created":"2017-05","Os":"Android","cnt":2},{"Created":"2017-05","Os":"iOS","cnt":1}]
}

目前有開啟推播的作業系統/人數

http://localhost:22222/rpt/activeCount

用來抓取目前有開啟推播的作業系統/人數，傳回內容

Example:


terry@MacBookAir ~ $ curl -X GET  "http://localhost:22222/rpt/activeCount"
{
[{"Os":"Android","cnt":17},{"Os":"iOS","cnt":5}]
}

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/circ/Hot_Loan"
{
[{"abbr":[""],"authors":["司馬光撰."],"ava":"unavailable","coverurl":[""],"docnumber":"005125891","format":"BK","isbn":[""],"publish":"中華,","subject":[""],"title":["資治通鑑"],"url":[""],"version":"第一版.","year":"民54."},{"abbr":[""],"authors":["草花里樹(Riki Kusaka)著 ; 鄭啓旭譯."],"ava":"unavailable","coverurl":[""],"docnumber":"006174901","format":"BK","isbn":[""],"publish":"東立,,","subject":[""],"title":["看護工向前衝 /"],"url":[""],"version":"","year":"2005-[民94-]."}]
}

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/circ/Hot_Hold"
{
[{"abbr":[""],"authors":["林奕含著."],"ava":"unavailable","coverurl":[""],"docnumber":"006467432","format":"BK","isbn":[""],"publish":"游擊文化,,","subject":[""],"title":["房思琪的初戀樂園 /"],"url":[""],"version":"初版","year":"2017."},{"abbr":[""],"authors":["慕顏歌著."],"ava":"unavailable","coverurl":[""],"docnumber":"006472546","format":"BK","isbn":[""],"publish":"采實文化 ,,","subject":[""],"title":["你的善良必須有點鋒芒 : 36則讓你有態度.不委曲,深諳世故卻不世故的世道智慧 /"],"url":[""],"version":"初版","year":"民106."},{"abbr":[""],"authors":["羅振宇等著."],"ava":"unavailable","coverurl":[""],"docnumber":"006467142","format":"BK","isbn":[""],"publish":"遠見天下文化,,","subject":[""],"title":["羅輯思維 : 我懂你的知識焦慮 /"],"url":[""],"version":"第一版","year":"2017."}]
}

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/circ/New_Book"
{
[{"abbr":[""],"authors":["Anselm Strauss, Juliet Corbin合著;徐宗國譯."],"ava":"unavailable","coverurl":[""],"docnumber":"005078258","format":"BK","isbn":[""],"publish":"巨流,,","subject":[""],"title":["質性研究概論 : grounded theory procedures and techniques = Basics of Qualitative Research /"],"url":[""],"version":"初版.","year":"民86[1997]."},{"abbr":[""],"authors":["民事訴訟法研究基金會編."],"ava":"unavailable","coverurl":[""],"docnumber":"005162974","format":"BK","isbn":[""],"publish":"民事訴訟法研討會,","subject":[""],"title":["民事訴訟法之研討 /"],"url":[""],"version":"初版","year":"1986- [民75- ]."},{"abbr":[""],"authors":["理查‧楊西(Richard Yancy)著;張錦娥譯"],"ava":"unavailable","coverurl":[""],"docnumber":"005233149","format":"BK","isbn":[""],"publish":"商周出版,","subject":[""],"title":["搞鬼稅務員"],"url":[""],"version":"初版","year":"民94[2005]"},{"abbr":[""],"authors":["吉米出主編"],"ava":"unavailable","coverurl":[""],"docnumber":"005240615","format":"BK","isbn":[""],"publish":"兆瑞,","subject":[""],"title":["中英文類比手冊 = Chinese-English words analogy handbook"],"url":[""],"version":"第一版","year":"2005[民94]"}]
}

廣告信開關設定-帳號_狀態(NO_YES)

http://webpac.lib.ccu.edu.tw:8888/api/letter_SMS?bor_id=9090&flag=yes

用設定廣告信開關，傳回內容


參數說明:
bor_id 讀者主證號
flag=yes 廣告信開
flag=no  廣告信關

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/letter_SMS?bor_id=9090&flag=yes"
{"status":"OK"}

薦購歷史清單(JAVA版)

http://webpac.lib.ccu.edu.tw:8888/api/rc_history?bor_id=9090

用來抓取薦購歷史清單(JAVA版)，傳回內容


參數說明:
bor_id 讀者主證號

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/rc_history?bor_id=9090"
{"status":"OK","authority":"N","bor_status":"碩士班學生可借30冊","delinq":"","rc_lists":[{"RC00_ID":"0000005184","RC00_TYPE":"01 ","RC00_TITLE":"世界末日與冷酷異境","RC00_AUTHOR":"村上","RC00_PUBLISHER":"時報","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20130111","RC00_PDATE":"20130111","SC01_DESC":"已有相關類似書籍,不採購","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000005184"},{"RC00_ID":"0000004745","RC00_TYPE":"01 ","RC00_TITLE":"1112測試","RC00_AUTHOR":"flysheet","RC00_PUBLISHER":"flysheet","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20121112","RC00_PDATE":"20121116","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004745"},{"RC00_ID":"0000004080","RC00_TYPE":"01 ","RC00_TITLE":"1111","RC00_AUTHOR":"1111","RC00_PUBLISHER":"1111","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004080"},{"RC00_ID":"0000004079","RC00_TYPE":"01 ","RC00_TITLE":"000","RC00_AUTHOR":"000","RC00_PUBLISHER":"000","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004079"},{"RC00_ID":"0000004078","RC00_TYPE":"01 ","RC00_TITLE":"999","RC00_AUTHOR":"999","RC00_PUBLISHER":"999","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004078"},{"RC00_ID":"0000004077","RC00_TYPE":"01 ","RC00_TITLE":"888","RC00_AUTHOR":"888","RC00_PUBLISHER":"888","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004077"},{"RC00_ID":"0000004076","RC00_TYPE":"01 ","RC00_TITLE":"777","RC00_AUTHOR":"777","RC00_PUBLISHER":"777","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004076"},{"RC00_ID":"0000004075","RC00_TYPE":"01 ","RC00_TITLE":"666","RC00_AUTHOR":"666","RC00_PUBLISHER":"666","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004075"},{"RC00_ID":"0000004074","RC00_TYPE":"01 ","RC00_TITLE":"555","RC00_AUTHOR":"555","RC00_PUBLISHER":"555","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004074"},{"RC00_ID":"0000004073","RC00_TYPE":"01 ","RC00_TITLE":"444","RC00_AUTHOR":"444","RC00_PUBLISHER":"444","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004073"},{"RC00_ID":"0000004072","RC00_TYPE":"01 ","RC00_TITLE":"333","RC00_AUTHOR":"333","RC00_PUBLISHER":"333","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004072"},{"RC00_ID":"0000004071","RC00_TYPE":"01 ","RC00_TITLE":"222","RC00_AUTHOR":"222","RC00_PUBLISHER":"222","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004071"},{"RC00_ID":"0000004070","RC00_TYPE":"01 ","RC00_TITLE":"111","RC00_AUTHOR":"111","RC00_PUBLISHER":"111","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"資料不全退件/ incomplete information","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004070"},{"RC00_ID":"0000004069","RC00_TYPE":"01 ","RC00_TITLE":"test","RC00_AUTHOR":"teset","RC00_PUBLISHER":"test","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20120821","RC00_PDATE":"20120827","SC01_DESC":"不受理/request denied","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000004069"},{"RC00_ID":"0000002144","RC00_TYPE":"01 ","RC00_TITLE":"飛資得測試1101","RC00_AUTHOR":"飛資得測試1101","RC00_PUBLISHER":"飛資得測試1101","RC00_PUBYEAR":"","RC00_ISBN_ISSN":"","RC00_CDATE":"20111102","RC00_PDATE":"20111102","SC01_DESC":"圖書館經費不足無法採購/insufficient funds to purchase","RC_URL":"http://webpac.lib.ccu.edu.tw:8080/rc/reader/rc11.jsp?rid=0000002144"}]}

取得書車目錄

http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_folder?bor_id=9090

用來抓取書車目錄，傳回內容


參數說明:
bor_id 讀者主證號

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_folder?bor_id=9090"
{"status":"OK","my_shelf":[{"Z129_SEQ":"00005","Z129_FOLDER":"哈利波特","COUNT":"2"},{"Z129_SEQ":"00009","Z129_FOLDER":"11111","COUNT":"5"},{"Z129_SEQ":"00015","Z129_FOLDER":"我的目錄&1","COUNT":"6"},{"Z129_SEQ":"00020","Z129_FOLDER":"BASKETX","COUNT":"5"},{"Z129_SEQ":"00028","Z129_FOLDER":"BASKETXX","COUNT":"2"},{"Z129_SEQ":"00031","Z129_FOLDER":"我來測試書目","COUNT":"1"}]}

取得書車目錄下的書目

http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_data?bor_id=9090&seq=00005

用來抓取書車目錄下的書目，傳回內容


參數說明:
bor_id 讀者主證號
seq    需要由"取得書車目錄下的書目"取出來的 Z129_SEQ 帶入

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_data?bor_id=9090&seq=00005"
{"status":"OK","my_shelf_data":[{"Z129_SEQ":"00001","Z13_REC_KEY":"005259926","Z13_TITLE":"哈利波特 : 死神的聖物","Z13_AUTHOR":"羅琳 (Rowling, J. K.)","Z13_YEAR":"2007","Z13_CALL_NO":"873.57 857:3-7 v.1","Z129_BASE":"TOP02","Z129_FOLDER":"哈利波特","Z129_NOTE":"哈利波特","Z13_IMPRINT":"皇冠文化"},{"Z129_SEQ":"00003","Z13_REC_KEY":"005254885","Z13_TITLE":"哈利波特 : 奇異的考驗","Z13_AUTHOR":"莫里斯 (Morris, Thomas V.)","Z13_YEAR":"2006","Z13_CALL_NO":"873.57 8855:5","Z129_BASE":"TOP02","Z129_FOLDER":"哈利波特","Z129_NOTE":"哈利波特","Z13_IMPRINT":"時報文化"}]}

加入書車-新增資料夾

http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_add?bor_id=9090&bib=006365658&folder=目錄名稱

用來加入書車-新增資料夾且加入書目，傳回內容


參數說明:
bor_id 讀者主證號
bib    書目系統號
folder 新增目錄名稱

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_add?bor_id=9090&bib=006365658&folder=目錄名稱"
{"status":"OK"}

加入書車-加到現有目錄

http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_add_by_seq?bor_id=9090&bib=006365659&seq=00028

用來加入書車-加到現有目錄，傳回內容


參數說明:
bor_id 讀者主證號
bib    書目系統號
seq    目錄的序號-由"取得書車目錄下的書目"取出來的 Z129_SEQ 帶入

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_add_by_seq?bor_id=9090&bib=006365659&seq=00028"
{"status":"OK"}

刪除書車下的書目或書車目錄與下面的資料

http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_del?bor_id=9090&seq=00004&type=D
http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_del?bor_id=9090&seq=00002&type=F

用來刪除書車下的書目或書車目錄與下面的資料，傳回內容


參數說明:
bor_id 讀者主證號
seq    需要由"取得書車目錄下的書目"取出來的 Z129_SEQ 帶入 或是"取得書車目錄下的書目"取出來的 Z129_SEQ 帶入
type   F為 目錄， 刪除目錄時會同時刪除目錄下的書目資料
type   D為 書目， 刪除書目資料

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_del?bor_id=9090&seq=00001&type=D"
{"status":"OK"}

terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/my_shelf_del?bor_id=9090&seq=00005&type=F"
{"status":"OK"}

取得薦購資料類型

http://webpac.lib.ccu.edu.tw:8888/api/rc_app_type?bor_id=9090

用來取得薦購資料類型，傳回內容


參數說明:
bor_id 讀者主證號

回傳資料說明：
這邊 rc_type  下面的資料是薦購資料類型，這邊要顯示在APP，新增薦購時需要帶入
這邊 currency 下面的資料是薦購使用的幣別，這邊要顯示在APP，新增薦購時需要帶入

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/rc_app_type?bor_id=9090"
{"status":"OK","msg":"","rc_type":[{"key":"01","value":"中日韓文圖書/East Asian language books"},{"key":"02","value":"西文圖書/Western language books"},{"key":"03","value":"中日韓文期刊/East Asian language journals"},{"key":"04","value":"西文期刊/Western language journals"},{"key":"05","value":"電子資源/E-resources"},{"key":"06","value":"視聽資料/Media resources"}],"currency":[{"key":"TWD","value":"新台幣"},{"key":"USD","value":"美金"},{"key":"EUR","value":"歐元"},{"key":"GBP","value":"英鎊"},{"key":"RMB","value":"人民幣"},{"key":"JPY","value":"日圓"},{"key":"HKD","value":"港幣"}]}

POST 新增薦購(JAVA版)

http://webpac.lib.ccu.edu.tw:8888/api/rc_app_add?bor_id=9090&type=01&title=題名&author=作者&publisher=出版者&isbn=9781231231234&pubyear=2017&edition=1版&vol=1&PTYPE=TWD&price=10.00&reserve=Y&Seen=我看過了&Note=備註欄位

用來新增薦購(JAVA版)，傳回內容


參數說明:
這邊 bor_id    是讀者主證號，這邊新增簽署時需要帶入
這邊 type      是資料類型，資料由"取得薦購資料類型"中的 rc_type，這邊新增簽署時需要帶入
這邊 title     是題名，在新增簽署時需要帶入
這邊 author    是作者，在新增簽署時需要帶入
這邊 publisher 是出版者，在新增簽署時需要帶入
這邊 isbn      是ISBN，在新增簽署時需要帶入
這邊 pubyear   是出版年，在新增簽署時需要帶入
這邊 edition   是版本，在新增簽署時需要帶入
這邊 vol       是卷期，在新增簽署時需要帶入
這邊 PTYPE     是幣別，資料由"取得薦購資料類型"中的 currency，這邊新增簽署時需要帶入
這邊 price     是價格，在新增簽署時需要帶入
這邊 reserve   是否預約，在新增簽署時需要帶入(這邊帶入Y/N)
這邊 Seen      是在那看過資料欄位，在新增簽署時需要帶入
這邊 Note      是備註，在新增簽署時需要帶入

Example:


terry@MacBookAir ~ $ curl -X POST  "http://webpac.lib.ccu.edu.tw:8888/api/rc_app_add?bor_id=9090&type=01&title=題名&author=作者&publisher=出版者&isbn=9781231231234&pubyear=2017&edition=1版&vol=1&PTYPE=TWD&price=10.00&reserve=Y&Seen=我看過了&Note=備註欄位"
{"status": "OK","msg": "Successful"}

POST 取得讀者簽署資料

http://webpac.lib.ccu.edu.tw:8888/api/sign_info?bor_id=9090

用來取得讀者簽署資料，傳回內容


參數說明:
bor_id 讀者主證號

回傳資料說明：
這邊 can_sign      是顯示是否能簽署， OK表示能簽署， NO表示不能簽署
這邊 barcode       是讀者證號，這邊新增簽署時需要帶入
這邊 Zip_field     是郵遞區號，需要顯示APP，這邊新增簽署時需要帶入
這邊 Address_field 是地址，需要顯示APP，在新增簽署時需要帶入
這邊 Email_field   是EMAIl，需要顯示APP，在新增簽署時需要帶入
這邊 Tel_field     是電話1，需要顯示APP，在新增簽署時需要帶入
這邊 Tel2_field    是電話2，需要顯示APP，在新增簽署時需要帶入
這邊 Tel3_field    是電話3，需要顯示APP，在新增簽署時需要帶入
這邊 Tel4_field    是電話3，需要顯示APP，在新增簽署時需要帶入

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/sign_info?bor_id=9090"
{"status":"OK","msg":"","can_sign":"NO","bor_id":"9090","barcode":"90901","Zip_field":"222","Address_field":"我的天字一號房我的天字一號房我的XXXx","Email_field":"nojkoy@qq.com","Tel_field":"0919305847x","Tel2_field":"(02)26589298_583x","Tel3_field":"0919305847xx","Tel4_field":"0981251027"}

POST 簽署新增(JAVA版)

http://webpac.lib.ccu.edu.tw:8888/api/sign_app_add?cardNo=9090&Zip_field=222&Address_field=我的天字一號房我的天字一號房我的x&Email_field=nojkoy@qq.com&Tel_field=0919305847x&Tel2_field=(02)26589298_583x&Tel3_field=0919305847xx&Tel4_field=0981251027

用來簽署新增(JAVA版)，傳回內容


參數說明:
這邊 cardNo        是讀者證號，由"取得讀者簽署資料"的barcode帶入
這邊 Zip_field     是郵遞區號，在新增簽署時需要帶入
這邊 Address_field 是地址，在新增簽署時需要帶入
這邊 Email_field   是EMAIl，在新增簽署時需要帶入
這邊 Tel_field     是電話1，在新增簽署時需要帶入
這邊 Tel2_field    是電話2，在新增簽署時需要帶入
這邊 Tel3_field    是電話3，在新增簽署時需要帶入
這邊 Tel4_field    是電話3，在新增簽署時需要帶入

Example:


terry@MacBookAir ~ $ curl -X POST  "http://webpac.lib.ccu.edu.tw:8888/api/sign_app_add?cardNo=9090&Zip_field=222&Address_field=我的天字一號房我的天字一號房我的x&Email_field=nojkoy@qq.com&Tel_field=0919305847x&Tel2_field=(02)26589298_583x&Tel3_field=0919305847xx&Tel4_field=0981251027"
{"Status": "OK"}

取得開閉館時間

http://webpac.lib.ccu.edu.tw:8888/circ/open_hours

用來取得開閉館時間，傳回內容


參數說明:
today 指定特定日期取得該日期的開閉館時間

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/circ/open_hours"
{"status":"OK","msg":"今日開館時間 08:10~21:00"}

取得開閉館時間 +熱門借閱、熱門預約、熱門新書

http://webpac.lib.ccu.edu.tw:8888/circ/home

用來取得開閉館時間 +熱門借閱、熱門預約、熱門新書，傳回內容


開閉館時間 +熱門借閱、熱門預約、熱門新書

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/circ/home"
{"Open_Housrs":[{"status":"NO","msg":"IP不允許使用"}]
,"Hot_Loan":[{"abbr":[""],"authors":["司馬光撰."],"ava":"unavailable","coverurl":[""],"docnumber":"005125891","format":"BK","isbn":[""],"publish":"中華,","subject":[""],"title":["資治通鑑"],"url":[""],"version":"第一版.","year":"民54."},{"abbr":[""],"authors":["草花里樹(Riki Kusaka)著 ; 鄭啓旭譯."],"ava":"unavailable","coverurl":[""],"docnumber":"006174901","format":"BK","isbn":[""],"publish":"東立,,","subject":[""],"title":["看護工向前衝 /"],"url":[""],"version":"","year":"2005-[民94-]."},{"abbr":[""],"authors":["弘兼憲史著;許嘉祥譯."],"ava":"unavailable","coverurl":[""],"docnumber":"006167260","format":"BK","isbn":[""],"publish":"尖端,,","subject":[""],"title":["社長島耕作 /"],"url":[""],"version":"一版","year":"2010[民99]-2014[民103]."},{"abbr":[""],"authors":["(宋)司馬光著"],"ava":"unavailable","coverurl":[""],"docnumber":"005203657","format":"BK","isbn":[""],"publish":"洪氏出版社,","subject":[""],"title":["資治通鑑"],"url":[""],"version":"初版","year":"民63[1974]"}]
,"Hot_Hold":[{"abbr":[""],"authors":["慕顏歌著."],"ava":"unavailable","coverurl":[""],"docnumber":"006472546","format":"BK","isbn":[""],"publish":"采實文化 ,,","subject":[""],"title":["你的善良必須有點鋒芒 : 36則讓你有態度.不委曲,深諳世故卻不世故的世道智慧 /"],"url":[""],"version":"初版","year":"民106."},{"abbr":[""],"authors":["林奕含著."],"ava":"unavailable","coverurl":[""],"docnumber":"006467432","format":"BK","isbn":[""],"publish":"游擊文化,,","subject":[""],"title":["房思琪的初戀樂園 /"],"url":[""],"version":"初版","year":"2017."},{"abbr":[""],"authors":["周慕姿著."],"ava":"unavailable","coverurl":[""],"docnumber":"006463331","format":"BK","isbn":[""],"publish":"寶瓶文化 ;,,","subject":[""],"title":["情緒勒索 : 那些在伴侶.親子.職場間,最讓人窒息的相處 /"],"url":[""],"version":"初版","year":"2017."},{"abbr":[""],"authors":["沃草烙哲學作者群著."],"ava":"unavailable","coverurl":[""],"docnumber":"006472564","format":"BK","isbn":[""],"publish":"究竟,,","subject":[""],"title":["現代草民哲學讀本 : 日常隨時烙哲學,用思考通樂人生 /"],"url":[""],"version":"初版","year":"2017."}]
,"Hot_New_Book":[{"abbr":[""],"authors":["Anselm Strauss, Juliet Corbin合著;徐宗國譯."],"ava":"unavailable","coverurl":[""],"docnumber":"005078258","format":"BK","isbn":[""],"publish":"巨流,,","subject":[""],"title":["質性研究概論 : grounded theory procedures and techniques = Basics of Qualitative Research /"],"url":[""],"version":"初版.","year":"民86[1997]."},{"abbr":[""],"authors":["民事訴訟法研究基金會編."],"ava":"unavailable","coverurl":[""],"docnumber":"005162974","format":"BK","isbn":[""],"publish":"民事訴訟法研討會,","subject":[""],"title":["民事訴訟法之研討 /"],"url":[""],"version":"初版","year":"1986- [民75- ]."},{"abbr":[""],"authors":["榮新江主編."],"ava":"unavailable","coverurl":[""],"docnumber":"005198614","format":"BK","isbn":[""],"publish":"北京大學出版社,,","subject":[""],"title":["唐研究 /"],"url":[""],"version":"","year":"1995-."}]}

POST 取得推播清單

http://webpac.lib.ccu.edu.tw:8888/api/msg_list?userid=D121775006

用來取得推播清單，傳回內容


參數說明:
userid 讀者主證號

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/msg_list?userid=D121775006"
[{"Created":"2017-08-03T15:46:29.447484081+08:00","Gid":14,"Userid": "D121775006","message":"書名:「當代中文課程」，條碼號：C06082739，已被其他讀者預約或取消預約，新到期日為2017/08/09，請於期限內歸還。","subject":"您借閱的館藏已被其他讀者預約或取消預約，請於新到期日前歸還。","view_flag":0},{"Created":"2017-08-03T15:35:04.781131727+08:00","Gid":1,"Userid": "D121775006","message":"書名:「虛擬貨幣革命:區塊鏈科技,物聯網經濟,顛覆性的支付系統挑戰全球經濟秩」，條碼號：C06068463，已於2017/08/02到館，預約保留到2017/08/10，請至圖書館辦理借閱。","subject":"您預約的館藏已到館，請至圖書館辦理借閱。","view_flag":1}]

POST 更新推播訊息已讀

http://webpac.lib.ccu.edu.tw:8888/api/set_read_msg?userid=D121775006&Gid=1

用來取得開閉館時間，傳回內容


參數說明:
userid 讀者主證號
Gid 推播流水號

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/set_read_msg?userid=D121775006&Gid=1"
{"status":"OK"}

POST 推播訊息-廣播用

http://webpac.lib.ccu.edu.tw:8888/api/broadcast?title=推播廣播&content=最近圖書館有活動-歡迎來館參加&number=1&btype=active&groupid=

用來推播訊息-廣播用


參數說明:
title   推播主旨
content 推播內容
number  推播序號(沒作用)
btype   是否收推播訊息(active:只推有設定有要收推播訊息  all:全部推送)
groupid 限定推播群組

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/broadcast?title=推播廣播&content=最近圖書館有活動-歡迎來館參加&number=1&btype=active&groupid="
[
    {
        "status": "OK"
    },
    {
        "Time": "2017-08-04T17:02:50.279692954+08:00",
        "Userid": "9090"
    },
    {
        "Time": "2017-08-04T17:02:50.299554039+08:00",
        "Userid": "D121775006"
    },
    {
        "Time": "2017-08-04T17:02:50.317881171+08:00",
        "Userid": "T123223848"
    }
]

POST 推播訊息-廣播用-有推播明細(可限定條件)

http://webpac.lib.ccu.edu.tw:8888/api/broadcast_v2?title=推播廣播&content=最近圖書館有活動-歡迎來館參加&number=1&btype=active&home_library=&bor_status=14&bor_type=AB

用來推播訊息-廣播用


參數說明:
title        推播主旨
content      推播內容
number       推播序號(沒作用)
btype        是否收推播訊息(active:只推有設定有要收推播訊息  all:全部推送)
home_library 限定辦證館別
bor_status   限定讀者狀態
bor_type     限定讀者單位

Example:


terry@MacBookAir ~ $ curl -X GET  "http://webpac.lib.ccu.edu.tw:8888/api/broadcast_v2?title=推播廣播&content=最近圖書館有活動-歡迎來館參加&number=1&btype=all&home_library=MA&bor_status=14&bor_type=AB"
[
    {
        "status": "OK"
    },
    {
        "Time": "2017-08-04T17:01:31.388485341+08:00",
        "Userid": "9090"
    }
]

alephapi 文件

API 索引

Server 啟動執行方式

參數說明

以下為 API 說明，目前全部都是用 HTTP 的協定

GET

POST

DELETE

PARAMS

:URL參數

語言

POST AUTH

PARAMS: userid, password

Example:

GET INFO

Example:

GET FIND

Example:

GET SORT

Example:

GET FETCH

Example:

POST STATUS

PARAMS: docnumbers

Example:

GET DETAIL

Example:

GET ITEMS

Example:

POST ITEMS

PARAMS: userid

Example:

POST BOOK

PARAMS: userid, barcode

Example:

POST RESTBOOK

PARAMS: userid, docnumber, reckey, location

Example:

POST CANCEL

PARAMS: docnumber, itemsequence, sequence

Example:

POST EXTEND

PARAMS: userid, barcode

Example:

GET QUERY

Example:

POST DEVICE

PARAMS: userid, device, os, subscribe

Example:

Example推播限制用:

POST MSG

PARAMS: userid, title, content, number

Example:

GET Version iOS

Example:

GET Version Android

Example:

百度憑認申請時綁定的網址

Example:

新增薦購API

Example:

GET Version Policy

Example:

GET Version Policy Eng

Example:

每個月/作業系統 初次安裝登入的人數

Example:

目前有開啟推播的 作業系統/人數

Example:

熱門借閱

Example:

熱門預約

Example:

熱門新書

Example:

廣告信開關設定-帳號_狀態(NO_YES)

Example:

薦購歷史清單(JAVA版)

Example:

取得書車目錄

每個月/作業系統初次安裝登入的人數

目前有開啟推播的作業系統/人數