Web Data-Provider Services

• Introduction
• Query for Person entity
• Query for Place entity
• Query for Date entity

Query for Person entity

URI format:

http://authority.dila.edu.tw/webwidget/getAuthorityData.php?type=person&id=<AuthorityID>&jsoncallback=<string>

Specification:

Argument	Value(s)	Description
type	"person"	Specifies the query type
id	<AuthorityID> | <string>	The DDBC Authority ID of the entity. Alternatively, a string may be specified which will serve as a query term.
jsoncallback	<string>	Required by third-party JavaScript libraries (e.g. EXT Js) to perform ajax functions. The value of jsoncallback has no effect on query processing, but will be attached to the beginning of the returned json string.

Example:

http://authority.dila.edu.tw/webwidget/getAuthorityData.php?type=person&id=A000004&jsoncallback=abc123

Json return (as accessed at 2010-11-01):

ddbcAuthPerson({
    "data1":{
        "authorityID":"A000004",
        "name":"畺良耶舍",
        "class":"譯經",
        "bornDateBegin":"+0383-01-01",
        "bornDateEnd":"+0383-12-31",
        "diedDateBegin":"+0442-01-28",
        "diedDateEnd":"+0443-02-15",
        "note":"最後出現在京師道林寺，宋元嘉十九年（442）後卒。（疑年錄：14）劉宋文帝元嘉元年（424）赴建業，卒於江陵，享年六十。四-五世紀。西域人，精通阿毘曇，除了律部之外對其他各經典也都有所研究。譯有《觀無量壽經》一卷及《觀藥王藥上二菩薩經》一卷，其中《觀無量壽經》對後世的淨土宗具有深遠的影響。（T50n2059_p0343c22；佛光：5537；佛百：4773.2；インド仏教：069）",
        "noteFull":"",
        "birthDateString":"卒於：劉宋, 文帝, 元嘉, 十九年，60歲",
        "deathDateString":"卒於：劉宋, 文帝, 元嘉, 十九年，60歲",
        "lang":"中文",
        "birthPlaceCode":"WW142XIYUE01AA",
        "birthPlaceName":"西域",
        "dynasty":"劉宋;",
        "names":"[梵文]: Kālayaśas [中文]: 時稱"
    }
})

Fields in Json string:

Field Name	Description
name	Authoritative name of the Person entity
authorityID	Authority ID of the Person entity
class	Class of the Person in the 高僧傳, “Biographies of Eminent Monks”, (T50n2059, T50n2060)
bornDateBegin	Earliest possible date for the birth of the Person Entity according to the calendrical assumptions
bornDateEnd	Latest possible date for the birth of the Person Entity according to the calendrical assumptions
diedDateBegin	Earliest possible date for the death of the Person Entity according to the calendrical assumptions
diedDateEnd	Latest possible date for the death of the Person Entity according to the calendrical assumptions
note	A short description of this Person
noteFull	A second description
birthDateString	A string representing the information in bornDateBegin and bornDateEnd
deathDateString	A string representing the information in diedDateBegin and diedDateEnd
lang	Language
birthPlaceCode	Code of the birth place relating to the Person entity
birthPlaceName	Name of the birth place relating to the Person entity
dynasty	Dynasty relating to the Person entity
names	Other names (and/or titles) associated with this Person entity

JavaScript example for processing json string:

function print_ddbcAuth_person(jsoncallback) {  // 'jsoncallback' is the string returned by the data-service
    var html='';
    html+='<table>';
    if(jsoncallback.data1.Name) {
        html+='<tr>';
        html+='<td><em>Names：</em></td><td>'+jsoncallback.data1.Name+'</td>';
        html+='</tr>';
    }
    if(jsoncallback.data1.Dynasty)  {
        html+='<tr>';
        html+='<td><em>Dynasty:</em></td><td>'+jsoncallback.data1.Dynasty+'</td>';
        html+='</tr>';
    }
    html+='</table>';
 
    echo html;
};