CBDB API

簡介

API (application programming interfaces) 是一種允許資料庫之間互相溝通的介面. 透過 API, 每個資料庫都可以取用其他資料庫的資訊, 來補充自己未能著重的資料面相, 而不必在自己資料庫重新輸入這些資料. 

 

CBDB 現在為其他資料庫提供API服務，讓任何資料庫都可以取用CBDB 人物傳記, 並於自己的資料庫呈現出來。CBDB API 現在支持兩種查詢方式：

  1. 用人物ID查詢 (CBDB ID)
  2. 用人名查詢 (漢字或拼音)

 

如何呼叫CBDB API

例：為王安石創建API Call

以程式送出以下http請求:

用人物ID查詢 (用CBDB ID取得人物傳記 ):

https://cbdb.fas.harvard.edu/cbdbapi/person.php?id=1762 (王安石的ID)

 

用人名查詢 (漢字或拼音):

https://cbdb.fas.harvard.edu/cbdbapi/person.php?name=王安石

https://cbdb.fas.harvard.edu/cbdbapi/person.php?name=wang%20anshi

 

輸出為 json 格式:

https://cbdb.fas.harvard.edu/cbdbapi/person.php?name=王安石&o=json

 

輸出格式

呼叫CBDB API後，我們會回傳關於此人在CBDB完整的傳記資料:

HTML格式

CBDB API 的 HTML 輸出：王安石，CBDB ID 1762、指數年 1080、生 1021 卒 1086、郡望太原，下接傳記註記、別名與歷任官職清單。
CBDB API HTML 輸出的後半：親屬關係表列出兄王安仁、弟王安禮、父王益、母吳氏、妻吳氏等及其出處；下接社會關係表，列同年友王越石、推薦人呂升卿、錢公輔等。

 

CBDB API 也支持另外 JSON 輸出格式：

CBDB API 的 JSON 輸出片段：PersonSources 陣列列出《宋人傳記資料索引（電子版）》《中國哲學書電子化計劃》《江南通志》等來源與頁碼，PersonAliases 列出字「介甫」、室名別號「半山老人」。

 

 

 

目前在使用CBDB API的資料庫有:

明清婦女著作 -- McGill大學

人名權威人物傳記資料  -- 中央研究院歷史語言研究所

Communication and Empire: Chinese Empires in Comparative Perspective -- Hilde De Weerdt

Digging into Data: Automating Chinese Text Extraction --  Peter K. Bol, Naomi Standen, Hilde De Weerdt