「取得 Authority 資料」：修訂間差異
出自DILA Wiki
imported>Winxd 無編輯摘要 |
imported>Winxd 無編輯摘要 |
||
| 行 11： | 行 11： | ||
=== 需要餵給程式的參數 === | === 需要餵給程式的參數 === | ||
1.<font color=red size=3><b>type：</b></font> | 1.<font color=red size=3><b>type：</b></font> 必須 指定 成「person」 。 | ||
2.<font color=red size=3><b>id：</b></font>就是你想要取得人名資料的唯一碼，可接受7碼的Pno(ex-A000004)和5碼的人名PrjNo(ex-B0006)。 | |||
3.<font color=red size=3><b>jsoncallback：</b></font>隨機產生的參數。 | |||
<table width="477" border="1"> | <table width="477" border="1"> | ||
<tr> | <tr> | ||
<td width="56" align="center">人名</td> | <td width="56" align="center">人名</td> | ||
<td width="405"> | <td width="405"></td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
| 行 30： | 行 32： | ||
</table> | </table> | ||
<br> | <br> | ||
<br><br> | <br><br> | ||
id和jsoncallback這兩個參數都必須給定，且id的格式須符合上面的說明。 | id和jsoncallback這兩個參數都必須給定，且id的格式須符合上面的說明。 | ||
於 2008年12月12日 (五) 10:35 的修訂
前言
由於各個專案可能有取得Authority資料的需求，因此這邊提供取得Authority的人名、地名、時間之方法，已方便各專案使用。
程式位置
http://elib.ddbc.edu.tw/authority/getAuthorityData.php
取得人名資料
需要餵給程式的參數
1.type：必須指定成「person」。
2.id：就是你想要取得人名資料的唯一碼，可接受7碼的Pno(ex-A000004)和5碼的人名PrjNo(ex-B0006)。
3.jsoncallback：隨機產生的參數。
| 人名 | |
| 地名 | 可接受13碼以上的地名編碼(ex-CN232723Z01AA)或地名的PrjNo(ex-Z0106105) |
| 時間 | 只接受d開頭的標記，如d331241335258 |
id和jsoncallback這兩個參數都必須給定，且id的格式須符合上面的說明。
使用範例
http://authority.ddbc.edu.tw/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：別名。
時間欄位說明
- 時間回傳值會有包含排版資訊(因為有並行年代的問題)，因此開發人員使用dateFrom和dateTo時直接print這兩個變數即可，無須再進行排版。
1.dateFrom：起始日期。
2.dateTo：結束日期。
