API

這個站的人物資料以 JSON 公開，可跨網域直接取用。共 162 人，範圍是第 11 屆立法委員，以及縣市正、副首長。

端點

GET /v1/people.json: 全部 162 人，完整內容。
GET /v1/people/<id>.json: 單筆，例如 /v1/people/TW-00141.json。

識別碼是 TW- 加五位序號，與網頁網址 /p/<id>/ 是同一個號。它由本站指派，不是官方編碼，指派後不會改變也不會回收。

取用條件

照片必須附出處。每筆 photo 都帶 credit_line，取用照片時請一併顯示。部分照片為 CC BY 或 CC BY-SA 授權，姓名標示是授權條件，不是禮貌。
黨籍要分清楚是誰說的。party.assigned_by_site 為 true 時，那是本站的判斷，不是查得到的官方資料—— 副首長為聘任職，公開資料沒有政黨欄。轉述時請不要把它呈現成官方事實。 party.source 寫明每一筆的依據。
party_history 只涵蓋擔任立法委員的屆別，來源是立法院資料 API。空陣列不代表這個人沒換過黨。
status 要看。目前全部是 active。日後若兩筆確認為同一人，舊 ID 會變成 merged 並帶 merged_into；若一筆確認為兩人，該 ID 作廢為 void。舊 ID 不會被刪除，也不會改指到別人。

回應範例

/v1/people/TW-00141.json 的 person 部分， party_history 只留最後一屆。

{
 "id": "TW-00141",
 "status": "active",
 "name": "陳超明",
 "party": {
  "name": "無黨籍",
  "assigned_by_site": false,
  "source": "立法院資料 API（ly.govapi.tw）"
 },
 "party_history": [
  {
   "term": "11",
   "party": "無黨籍",
   "caucus": "中國國民黨",
   "district": "苗栗縣第1選舉區",
   "from": "2024-02-01",
   "to": "2028-01-31"
  }
 ],
 "roles": [
  {
   "dept": "立法院",
   "title": "立法委員"
  }
 ],
 "district": "苗栗縣第1",
 "city": null,
 "photo": {
  "url": "https://roster.heiwao.com/avatars/sm/%E9%99%B3%E8%B6%85%E6%98%8E.jpg",
  "credit_line": "立法院官方網站",
  "source": "立法院官方網站",
  "artist": null,
  "licence": null,
  "page": null
 },
 "slugs": [
  "陳超明"
 ],
 "wikidata": null,
 "links": {
  "self": "https://roster.heiwao.com/v1/people/TW-00141.json",
  "page": "https://roster.heiwao.com/p/TW-00141/",
  "ledger": "https://ledger.heiwao.com/p/%E9%99%B3%E8%B6%85%E6%98%8E/"
 }
}

版本

路徑裡的 v1 是契約：欄位只會新增，不會移除，也不會改變原有的意思。需要破壞性變更時會另開 /v2/， /v1/ 繼續供應。

資料變動日期：2026-08-04。回應的 data_updated 只在資料實際變動時更新，重新建置不會改變它。

資料來源

監察院廉政專刊（財產申報）
立法院資料 API（ly.govapi.tw）
維基共享資源、Wikidata