應用程序接口（API）說明書

數字人文項目組2017年5月8日

一、綜述

手稿開放數據接口目前提供以下兩種形式的數據接口。

1.通過訪問資源URI獲取數據：根據標準API接口,通過訪問單個資源的URI,獲得

該資源的所有RDF三元組（屬性和值）。

2.通過查詢接口獲取特定類型的數據：通過特定API接口，獲取"人名"、"異名"、

"手稿"、"地點"、"機構"、"朝代"等的數據。（每次最多取得20條數據）

3.通過SparqlEndpoint獲取數據

注：使用手稿開放數據接口時需要提供APIKey進行驗證。（即：參賽報名時，自己注

冊用戶時得到的ApiKey,已發送至您的注冊郵箱：發件人為）。

二、接口調用方式說明

1.通過訪問資源URI獲取數據

功能：輸入資源URI,獲取資源的RDF數據。如返回結果數據中存在其他資源的

URI時，可通過該接口獲取其他資源的RDF數據。

API接口:

[參數l]&key=[參數2]

輸入：

[參數1]:資源URI

[參數2]:用戶的APIKey

輸出：包含資源及其屬性和值的JSON-LD數據

資源類型與URI設計規范：

對象命名空間

實例(bf:Instance)/sg/resource/instance/

朝代/authority/temporal/

版本類型取值詞表/vocab/edition/

作品(bf:Work)/sg/resource/work/

創作地/entity/place/

機構/entity/organization/

單件(bfrltem)/sg/resource/item/

人物/entity/person/

異名/entity/nameOther/

題記/sg/resource/inscription/

信封/sg/resource/envelope/

信紙/<;g/re<;oijrce*/lf?tterpaper/

貢獻/sg/resource/contribution/

多媒體特征/sg/resource/mediacharacteristic/

藏書票/sg/resource/bookplate/

印章/sg/resource/seal/

例如：

輸入：？

uri=

輸出：

(

"(?graph":[

(

“@type":

"contribution":

"dimensions":"6.5cmxl9cm",

"extent":"1頁"，

"instanceOf":

"place":

"publisher":"已刊稿，

"title":"審稿，

"created":"[不詳「，

"identifier":"CG000002",

"issued":"2000",

"binding":"未裝訂",

"color":"黑色，

"description":"畫里話",

"placevalue":[

"中國"，

"北京"

]

},

{

"@type":

"heldBy":

"itemOf":""

},

(

"@type":

"contentcategory":

"@id":""

},

"originDate":“不詳|”,

"originPlace":[

“中國“，

"北京"

L

"creator":"方成(著)",

"language":"漢語”，

"subject":(

"學科標簽：null,學科地點：中國，學科時代：當代，學科名字：雜文，

"關鍵詞：封建主義"

"title":"審稿(十年回憶之七廣,

"description":"附《審稿》漫畫復印件一頁"

}

I

"@context":{

"identifier":

"binding":

"title":

"publisher":

"issued":

"extent":

"dimensions":

"description":

"instanceOf"：{

"@type":"@id"

},

"placevalue":

"color":

"contribution":{

"@type":"@id"

},

"place":{

"@type":"@id"

},

"created":

"originPlace":

"contentcategory":{

"@type":"@id"

},

"creator":

"subject":

"originDate":

"language":

"heldBy":{

"@type":"@id"

},

"itemOf":{

“@type":"@id"

}

)

返回屬性說明：

屬性理說明

contributionURI貢獻者

dimensionsliteral尺寸

extentliteral贓

instanceOfURI作品

placeURI地點

publisherliteral出版者

titleliteral正書名

createdliteral創建時間

identifierliteral標識符

issuedliteral發表時間

bindingliteral裝訂方式

colorliteral顏色

descriptionliteral描述

placeValueliteral地點

heldByURI所有者

itemOfURI實例

contentcategoryURI資源類型

originDateliteral出版時間

originPlaceliteral出版地

creatorURI責任者

languageliteral語種

subjectliteral主題

2.通過查詢接口獲取特定類型的數據

(1)人名

功能：輸入人的姓名，得到該人名的相關信息

API接口：［參數l］?key=［參數2］

輸入：

［參數1］：人名

［參數2］:用戶的APIKey

輸出：和該人相關的所有屬性值

例如：

輸入：

輸出：

［

(

"@type":

"identifier"："AOOOOOl",

"friendOf":(

ItII

I

"birthday":"1904",

"briefBiography":"著名作家,文學翻譯家,曾任中國文聯副主席，作協主席，作協上海分會主席.原名李堯常，字芾」.，筆名

王文懣，歐陽鍍落黃樹輝，余一，余三，余五，余匕巴比，比金，佩華等泗川成都人.1927年赴法留學,1927年底網同編輯

《文學叢刊》,從事文學創作.1934年冬游學日本，次年8月回國.之后，任上海文化生活出版社，平明出版社總編林1949

年至今，歷任中國作協副主席，上海分會主席，《文藝月報》，&收獲:E,￡上海文學》主編，中國文聯副主席，中國作協主

席,全國政協副主席等職.著有?長篇小說《滅亡3,6家》，《春》，￡秋》等，譯有《處女地3,《往事與隨想?」，

"createdWork":"￡第四病室》；《的想錄》”，

"ethnicity":

"name":[

nationality":

nativePlace":

noteOfSource"：（

20世紀中文著作者箔名錄：：",

中國近現代人物名號大辭典：："

),

officialEvent":[

"speciality":"作家，

"gender"："W",

[

(

"@language":"cht",

"@value-：吧金?

}.

(

"^language":"chs",

"?value":"巴金"

"@language":"en",

"@value":"bajin"

)

),

"@context":{

"name":{

"@tvpe":"@id"

},

"officialEvent":{

"@tvpe":"@id"

"friendOf"：{

"@type":"@id"

"createdWork":

"gender":

"nationality":{

"@tVpe":"@id"

}，

"identifier":

"briefBiography":

"nativePlace":{

"@type":"@id"

"speciality":

"birthday"：

"noteOfSource":

"ethnicity":{

"@type":"@id"

}

)

1

返回屬性說明:

屬性類型說明

姓名

value:姓名

language:若吉

foafnameliteral

"chs":中又簡體

"cht":中文繁體

"en":英文

identifierliteral標識符

friendOfURI朋友

birthdayliteral生于

briefBiographyliteral小傳

createdWorkliteral著作

ethnicityURI民族

nameURI名稱

nationalityURI國籍

nativePlaceURI籍貫

noteOfSourceliteral來源說明

officialEventURI任職事件

specialityliteral專長

genderURI順

(2)人員列表高級檢索

功能：輸入人名、生卒年等相關查詢條件，得到人員列表信息

API接口:

［參數l］&birthday=［參數2］&deathday=［參數3］&gender=［參數4］&

officialPosition=［參數5］&name=［參數6］&nationality：［參數7］ðnicity=［參數

8］&birthPlace=［參數9］&key=［參數10］

輸入：

［參數1］:人名

［參數2］:生于

［參數3］：在于

［參數4］:性別

[參數5]:職銜

[參數6]:名稱(別稱、世稱、小名.…)

[參數7]:國籍

[參數8]:民族

[參數9]:匕生地

[參數10]:用戶的APIKey

輸出：輸出與查包條件匹配的人員列表

例如：

輸入：

二巴金&key=l

輸出：

(

{

"start":"1904",

"speciality"："作家"，

"place_uri":

"place":"成都，

"long":"104.07",

"uri"：

"fname":"巴金"，

"end":

"lat":"30.67",

"briefBiography":"著名作家,文學朝譯家，曾任中國文聯副主席，作協主席，作協上海分會主席.原名李堯棠，字芾寸，筆名

王文慈，歐陽鏡蓉,黃樹輝，余一，余三，余五，余七，巴比，比金，佩華等.四川成都人.1927年赴法留學,1927年底何國蒯輯《文學叢

刊》，從事文學創作.1934年冬游學日本，次年8月回國.之后，任上海文化生活出版社，平明出版社總編軾.1949年至今，歷任中

國作協副主席，上海分會主席，《文藝月報》，6收狹》，0上海文學》主焉，中國文聯副主席,中國作協主席，全國政協副主席等

職.著有長篇小說《滅亡》，《家》,《春》，6秋》等，洋有《處女地》，《往事與隨想》

}

1

返回屬性說明：

屬性建說明

fnameliterial姓名

startliteral出生日期

endliteral死亡日記

place_uriURI籍貫Uri

placeliterial籍貫

longliteral籍貫經度

latliteral籍貫緯度

specialityliteral然

briefBiographyliteral小傳

(3)人員列表簡單檢索

功能：輸入關鍵字或關鍵詞，得到符合該關鍵字或關鍵詞的人員列表

API接口:

[參數1]&key=[參數2]

輸入：

[參數1]:全文檢索關鍵字

[參數2]:用戶的APIKey

輸出：輸出與查詢條件匹配的人員列表

例如：

輸入：

輸出：

"start":"1894",

"speciality":

"place_uri"："O",

"place":"紹興，

"long":"120.57",

"uri":"?"，

"fname”:■孫伏園"，

"end":"1966",

"lat"："30",

年北京大學畢業.在校時參加新潮社，任干事兼編輯，乂任圖書館長李大釗秘書年兼任

"briefBiography":"1921.1920

北京《晨報》編輯，畢業后主編￡宸報副刊》，參加發起文學研究會.1924年發起創辦《語絲》周刊，改任6京報副刊》編缸1926

年赴廈門大學，任國學院編輯部干事.次年初轉廣州中山大學，任史學系主史.不久到武漢主編《中央H報副刊》.同年冬回上

海，與友人創辦嘍嚶書屋，出版《貢獻》，《當代》.1928年赴法留學.回國后在河北定縣，從事教育工作.1937,1938年間曾任衡

山實驗縣縣長.后至重慶，任第二屆文藝界抗協理事，齊魯大學國史系主任推教授，創辦中外出版社，抗日勝利后任華西大學及

四川大學教授，并主持《新民報》副刊.著有￡自迅二三事》，《山野掇拾2等J

}，

(

"start":"1904.12",

"speciality":"作家，

"place_uri":"O",

"place":"安縣"，

"long":"104.57",

"uri"："?"，

"fname":"沙汀，

"end":

"lat":"31.53",

"briefBiography":"小說家原名楊朝熙，又名楊子百，落名沙汀，尹光，曾任中國作家協會副主席等職，四川安縣人.1926

年畢業于四川省立第一師范.1929年到上海與人合辦辛星書店.1931年開始創作,次年金加左聯，曾任左聯常務秘氏抗戰埸發

后到延安，曾任魯藝文學系代主任.1938年11月隨賀龍去晉西北和冀中.1940年以后在重慶和故鄉從事寫作.新中國成立后,

歷任四川文聯主席，作協四川分會主席，中國科學院文學研究所所長.著有6淘金記》，6木雨山》等J

},

{

"start":"1913",

"speciality":"作家，

"place_uri":"?",

"place":"襄陽，

"long":"112.2",

"uri":"0",

XMUD”；叼K九年，

"end":"2002.1",

"lat":"32.08",

"briefBiography":。詩人，文學評論家，中國作辦副主席.原名張文光.湖北光化人.1927年加入共者團.之后曾當過學徒,

書店店員，小學教員.三十年代初曾在武漢私立大學肆業，任教中學.1937年加入中國共產黨，后到延安,創作著名組詩T黃河大

合唱》.乂在重慶，緬甸，昆明等地從事抗日活動.1946年后主持北方大學藝術學院，華北大學文藝學院教學工作.新中國成立后,

任中國作協書記處書記，副主席和常務書記等職.著有《戲刷的現實主義問題》，《文藝漸論集》，詩集《五月花》，長篇敘事

詩《阿細人的歌》等

返回屬性說明：

類型說明

fnameliterial姓名

startliteral出生日期

endliteral逝世日期

place.uriURI籍貫Uri

placeliterial籍貫

longliteral籍貫經度

latliteral籍貫緯度

spprialityliteral專長

briefBiographyliteral小傳

(4)地名

功能：輸入地名，得到符合該地名的相關信息

API接口:

［參數l］?key=［參數2］

輸入：

［參數1］：地名

［參數2］:用戶的APIKey

輸出：輸出與該地名相符的相關信息

例如：

輸入：

輸出：

"@tvpe":

"label":[

(

"@language":"cht",

"?value':"杞捌

},

(

"@language":"chs",

"@value":"杞縣"

}

]，

"city"：“開封市“，

"country',:(

(

"?language":"chs",

“@valW:"中國.

},

(

"@language":"cht",

"(?value'："*0"

)

],

"county":"杞縣"，

"province":"河南省，

"lat":"34.55",

"long":"114.78",

"@context":{

"label";

"long"：

"lat":

"country":

"city"：

"county":

"province":""

}

}

返回屬性說明：

屬性理說明

labelliteral縣

cityliteral市

countryliteral國家

provinceliteral省

latliteral緯度

longliteral經度

(5)地名列表

(一)功能：得到關鍵詞所對應的中國地點列表

API接口:

http:〃?key=［參數1］

［參數1］：用戶的APIKey

輸出：輸出國內地點列表

輸出：

{

"prov":"上海"，

"county":"浦東新區"，

"uri":

"dty":"上海市“

},

{

"prov":"上海市"，

"county"：

"uri":

"city"：""上海市“

},

(

"prov":"上海市"，

"county":"南匯區”，

"uri":

"city"："上海市"

"prov":"上海中，

"county":"嘉定區”,

"uri":

"city”："上海市"

},

(

"prov":"上海市"，

"county":"奉貨區，

"uri":

"city”："上海市“

}，

(

"prov":"上海市"，

"county":"寶山區，

"uri":

"city”:-上海市“

"prov":"上海市"，

"county":"崇明縣”,

"uri":

"city”：?上海市“

｝，

(

"prov":"上海市"，

"county":"徐匯區”,

"uri":

"city”：?上海市“

"prov":"上海巾"，

"county":"普陀區，

"uri":

"city":"上海市"

"prov":"上海市"，

"county":"松江區”，

"uri":

"city"："上海市"

｝，

(

"prov":"上海市"，

"county":"浦東新區”,

"uri":

"city"："上海市"

｝,

(

"prov":"上海南"，

"county":"虹口區”，

"uri":

"citY”："上海市“

｝，

(

"prov"："上海市"，

"county":"金山區”，

"uri":

"city”:1■上海市"

"prov":"上海市"，

"county":"閔行區，

"uri":

"city"："上海市"

"prov":"上海市"，

"county":哨浦區”,

"uri":

"dty"：■■上海市“

｝，

(

"prov":"云南省"，

"county":

"uri":

"city":""

｝，

(

“prov"：”云南省”，

"county":

"uri":

"city”:“臨滄市"

｝,

(

"prov":"云南省"，

"county":"永德縣",

"uri":

"city":"臨滄市"

｝.

(

"prov":"云南省"，

"county":

"uri":

"city”:*麗江市"

（二）功能：得到國外地點列表

API接口:

http:〃?key=［參數1］

［參數1］：用戶的APIKey

輸出：輸出國內地點列表

輸出：

數據結構同（一）

返回屬性說明：

屬性類型說明

provliterial省

countryliterial地名（對應"國家"、"省"、"市"、"縣"中的最小行政區劃）

uriliterial地區uri

cityliterial市

（6）朝代

功能：

1.輸入朝代、年號，獲取朝代起止年數據。

2.輸入年號紀年，獲取公元年數據。

3.輸入公元年，返回朝代紀年。

4.輸入朝代，返回年號、帝王、起止年

5.獲取所有朝代

API接口:

［參數l］.json?key=［參數2］

輸入方式1:

［參數1］：朝代或朝代年號。

［參數2］:用戶的APIKey

輸出：朝代起止年的JSON-LD數據（數組格式）

例如：

輸入：

輸出：

{

"result":{

"data":"1368~1644",

"uri":""

）

)

輸入方式2:

［參數1］：朝代紀年。

［參數2］:月戶的APIKey

輸出：公元年的JSON-LD數據（數組格式）

例如：

輸入：

輸出：

（

"result":{

"data":"1369-,

"uri"：""

}

}

輸入方式3:

［參數1］:公元年。

［參數2］:用戶的APIKey

輸出：朝代紀年的JSON-LD數據（數組格式）

例如:

輸入：

輸出：

［

"result":{

"data":"明,元至正29年，明2年,明洪武2年”，

"uri":""

）

}

輸入方式4:

［參數1］：朝代。

［參數2］:用戶的APIKey

輸出：朝代紀年的JSON-LD數據（數組格式）

例如:

輸入：

輸出：

{

"result":［

（

"monarch":

"reignTitleM:

"monarchName":

"label":"秦，

"urf：

"dynasty":"秦，

"end":"-206",

"begin":"-221"

},

{

"monarch":"始皇帝，

"reignTitle":

"monarchName":"樹政'，

"label"："秦"，

"uri":

"dynasty":"秦，

"end":"-210",

"begin":"-221"

},

（

"monarch"："二世，

"reignTitle":",

"monarchName":"巔胡亥"，

"label":"秦，

"uri-：

"dynasty"："秦，

"end":"-207",

"begin":"-209"

I

（

"monarch":

"reignTitle":

"monarchName"："嬴子嬖"，

"label":"秦，

"uri"：

"dynasty"："秦，

"end":"-206",

"begin":"-206"

},

（

"monarch":

"reignTitle":"秦興，

"monarchName":"薛舉'，

"label":"秦秦興，

"uri":

“dynasty“：“秦，

"end":"618",

"begin":"617-

）

]

）

輸入方式5:

[參數1]:temporal.json

[參數2]:用戶的APIKey

輸出：朝代紀年的JSON-LD數據（數組格式）

例如：

輸入：

輸出：

(

"data":(

(

"uri":

"label":"夏，

"end":

"begin":"-1989"

},

(

"uri":

"label":"商，

"end":

"begin":--1559"

}，

]

}

返回屬性說明：

屬性類型說明

labelliterial朝代名稱

beginliterial朝代開始時間

endliterial朝代截止時間

dynastyliterial朝代

monarchliterial帝王

monarchNameliterial帝王姓名

reignTitleliterial年號

(7)人員URI內容協商

功能：根據人員Uri,得到該人員的詳細信息

API接口:

輸出：輸出該人員的詳細信息

例如:

輸入：

json

輸出:

result":{

data":{

@id":

@type":

identifier":"A000001",

friendOf":[

],

"birthday":"1904",

"briefBiography"："著名作家，文學翻譯家，曾任中國文聯副主席，作協主席，作協上海分會主席.原名李堯棠，字

芾甘，筆名王文慈，歐陽鏡蓉,黃樹輝，余，余三，余五，余七，巴比，比金，佩竿等.四川成都人.1927年赴法留

學,1927年底回國，編輯《文學從刊》，從事文學創作.1934年冬游學日本，次年8月回國.之后，任上海文化生活

出版社，平明出版社總編輯.1949年至今..…",

"createdWork":"《第四病室》；《隨想錄》",

"ethnicity":

"name":[

],

nationality":

nativeplace":

noteOfSource":[

20世紀中文著作者筆名錄；："，

中國近現代人物名號大辭典：："

],

officialEvent":[

Illi

】，

"speciality":"作家，

"gender":"男，

[

(

"@language":"cht",

"@value":"巴金"

"@language":"chs",

”@value":"巴金"

"@language":"en",

"@value":"bajin"

)

L

"@context":{

"name":{

"@type":"@id"

},

"officialEvent":{

"@type":"@id"

},

"friendOf":{

"@type":"@id"

},

"createdWork":

"gender":

"nationality":{

"@type":"@id"

},

',identifier":

"briefBiography":

"nativePlace":{

"@type":"@id"

},

'?speciality":

"birthday":

"noteOfSource":

"ethnicity":{

"@type":"@id"

)

)

)

)

)

返回屬性說明：

屬性類型說明

identifierliteral標識符

friendOfUri朋友

birthdayliteral生于

briefBiographyliteral小傳

createdWorkliteral著作

ethnicityliteral民族

nameUri名稱

nationalityUri國籍

nativePlaceUri籍貫

noteOfSourceliteral來源說明

officialEventUri任職事件

specialityliteral專長

genderliteral性別

foafmameliteral姓名

(8)WorkURI內容協商

功能：根據workUri,得到該workUri的詳細信息

API接口:

輸出：輸出得到亥workUri的詳細信息

例如：

輸入：

輸出：

{

"result11:{

"data":{

"@graph":[

{

"@type":

"contribution":

"dimensions":"6.5cmxl9cm",

"extent":"1頁"，

-instanceOf":

"place":

"publisher":"已刊稿，

"title":"審稿",

"created":"[不詳口

"identifier":"CG000002",

"issued":"2000",

"binding":"未裝訂"，

"color":"黑色，

"description":"畫里話，

"placeValue":(

"中國，

"北京"

"@type":

"heldBy":

"itemOf":""

},

(

"@type":

"contentcategory":

},

"originDate":"不詳『，

"originPlace":(

"中國",

"北京"

】，

"creator":"方成(著)"，

"language":"漢語，

"subject":[

"學科標簽：null,學科地點：中國，學科時代：當代，學科名字：雜文",

"關鍵詞：封建主義"

]，

"title":"審稿(十年回憶之七)"，

"description":"附《審稿》漫畫復印件一頁"

)

],

"@context":{

"identifier":

"binding":

"title":

"publisher":

"issued":

"extent":

"dimensions":

"description":

"instanceOf":{

"@type":"@id"

},

"placeValue":

"color":

"contribution":{

"@type":"@id"

},

"place":{

"@type":"@id"

},

"created":

"originPlace":

"contentcategory":{

"@type":"@id"

},

"creator":

"subject":

"originDate":

"language":

"heldBy":{

"@type":"@id"

},

"itemOf":{

“@type":"@d'

)

)

)

)

}

返回屬性說明：

屬性艇說明

contributionURI貢獻者

dimensionsliteral尺寸

extentliteral數量

instanceOfURI作品

placeURI地點

publisherliteral出版者

titleliteral正書名

createdliteral創建時間

identifierliteral標識符

issuedliteral發表時間

bindingliteral裝訂方式

colorliteral蹶色

descriptionliteral描述

placeValueliteral地點

heldByURI所有者

itemOfURI實例

contentcategoryURI資源類型

originDateliteral出版時間

originPlaceliteral出版地

creatorURI責任者

languageliteral語種

subjectliteral主題

(9)work列表高級檢索

功能：輸入正書名、人名、手稿類型、語種等查詢條件，得到與查詢條件相符的

work列表

API接口:

二［參數l］&person=［參數2］&personllri=［參數3］&dataType;［參

數4］&startDate=［參數5］&endDate=［參數6］&language=［參數

7］&year=［參數8］&key=［參數10］

輸入：

［參數1］：主題詞

［參數2］:人名

［參數3］：人名Uri

［參數4］:手稿類型【信函、電報、賬期賬單、公牘、合同、奏折、地底、詩

文、諭旨、照片、條約、目錄、日記、圖表、書報、其他、章程、筆記、創作

手稿、簽名本、實物、書畫篆刻、音像資料、證件、證書、紙質資料】

［參數5］:創作開始時間

［參數6］:創作結束時間

［參數7］:語種

［參數8］:創作年代

［參數9］:月戶的APIKey

說明：所有參數為非必須輸入，參數4中，必須傳入括號內規定類型值。

輸出：輸出與查詢條件相符的work列表

例如：

輸入：

輸出：

title《全集》序言，

typeValue創作手稿，

urihttpdata.Isgresourceworkwaoov4vrzfuosrs4

title《家》《春》&秋》簽名本封面復制件，

typeValue紙質資料,

urihttpdata.Isgresourceworkkgwswt8sfiune3zk

title《巴金全集》（共二十六冊），

typeValue簽名本，

urihttpdata.Isgresourcework0x7xcnazrlllzjqy

title《巴金全集》10,

typeValue簽名本，

urihttpdata.Isgresourceworkrn0yr2ksm2znx8gh

title《巴金全集》11,

typeValue簽名本，

urihttpdata.Isgresourceworkjy5pj5b041aw23hg

title《巴金全集》12,

typeValue簽名本，

urihttpdata.Isgresourceworks5om5gv0szjb5n5l

title《巴金全集》13,

typeValue簽名本，

urihttpdata.Isgresourceworkevpbl5a0jr6qqs5n

title《巴金全集》14,

typeValue簽名本，

urihttpdata.Isgresourceworkwe061imwafaoc3v>

title《巴金全集》15,

typeValue簽名本，

urihttpdata.Isgresourceworkx5gl48z4yk67mck7

title《巴金全集》16,

typeValue簽名本，

urihttpdata.Isgresourceworkfjpke0csyl8kvqpg

title《巴金全集》18,

typeValue簽名本，

urihttpdata.Isgresourcework6ynn0me0kczu76tl

title《巴金全集》19,

typeValue簽名本，

urihttpdata.Isgresourceworklui6ptjqk46mhnky

title《巴金全集》20,

typeValue簽名本，

uriht