「取得 Authority 資料」:修訂間差異

出自DILA Wiki
imported>Winxd
imported>Winxd
無編輯摘要
行 64: 行 64:
=== 時間欄位說明 ===
=== 時間欄位說明 ===


待補完
1.dateFrom:起始日期。<br>
2.dateTo:結束日期。<br>
 
*時間回傳值會有包含排版資訊(因為有並行年代的問題),因此開發人員使用dateFrom和dateTo時直接print這兩個變數即可,無須再進行排版

於 2008年11月10日 (一) 09:45 的修訂

前言

由於各個專案可能有取得Authority資料的需求,因此這邊提供取得Authority的人名、地名、時間之方法,已方便各專案使用。

程式資訊

程式位置

http://elib.ddbc.edu.tw/authority/getAuthorityData.php

需要餵給程式的參數

1.id:就是你想要取得資料的唯一碼,格式說明如下:

人名 可接受7碼的Pno(ex-A000004)和5碼的人名PrjNo(ex-B0006)
地名 可接受13碼以上的地名編碼(ex-CN232723Z01AA)或地名的PrjNo(ex-Z0106105)
時間 只接受d開頭的標記,如d331241335258


2.jsoncallback:隨機產生的參數。

id和jsoncallback這兩個參數都必須給定,且id的格式須符合上面的說明。

使用範例

http://elib.ddbc.edu.tw/authority/getAuthorityData.php?id=T13005441&jsoncallback=jsoncallback12345

回傳資料

程式的回傳資料為json格式,開發人員可讀取此json結果來顯示Authority的內容。

欄位說明

由於人名、地名、時間三者回傳的資訊都不一樣,欄位也不同,茲說明如下:

人名欄位說明

1.Project_No:專案碼,即此筆人名資料的專案編號。
2.Class:分類。
3.Note:註解。
4.Year:生卒年。
5.Dynasty:朝代。
6.Names:別名。

地名欄位說明

1.Code:地名編碼,地名的唯一碼。
2.Pname:行政區。
3.XY:座標。
4.Dynasty:朝代。
5.County:County。
6.Note:註解。
7.Names:別名。

時間欄位說明

1.dateFrom:起始日期。
2.dateTo:結束日期。

  • 時間回傳值會有包含排版資訊(因為有並行年代的問題),因此開發人員使用dateFrom和dateTo時直接print這兩個變數即可,無須再進行排版。