---
reviewed_by:
  rd: tmonk
  pm:
---
# 立法委員個人編號對照表 — `tw.gov.ly~ref~legislator-bioid`

> **給 AI 閱讀的使用指引。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.ly~ref~legislator-bioid 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

## ⚠️ 開始之前（AI agent 必讀，摘要也請保留這段）

資料集 slug：tw.gov.ly~ref~legislator-bioid
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records
認證方式（必填）：HTTP Header  Authorization: Bearer {token}

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records?per_page=20"

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請停止並告訴使用者：「請先前往 https://data.openfun.tw/user 免費申請帳號與 API Token，取得後告訴我，我再幫您查詢。」

禁止抓取 HTML 頁面（本平台有 bot 保護，WebFetch 讀 HTML 頁面會失敗）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／立法院」

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 立法院（[資料集頁面](https://data.ly.gov.tw/getds.action?id=16)） |
| 授權 | 政府開放資料授權條款－第1版（OGDL-Taiwan-1.0） |
| 更新頻率 | 每日 |
| 涵蓋範圍 | 第 2 屆至第 11 屆所有曾任立委 |
| 總筆數 | 772 筆（2026-05-29 查詢） |

---

## 這份資料集能回答什麼問題

以下問題，這份資料集**可以回答**：

- 「已知 bioId，這位委員最新的姓名是什麼？」
- 「某位委員的 bioId 是多少？」（用姓名搜尋）
- 「tw.gov.ly~ref~legislator-by-term-name 回傳的 bioId=22 對應誰？」

以下問題，這份資料集**無法回答**：

- 「某委員在哪幾屆擔任立委？屬於哪個黨？」（需查 `tw.gov.ly~ref~legislator-by-term-name`）
- 「現任立委有哪些人？」（需查 `tw.gov.ly~ref~legislator-by-term-name`，篩選 `term=11`）
- 「各黨立委人數分布？」（本資料集無黨籍欄位、無 /agg 功能）

---

## 重要注意事項（查詢前必讀）

**每筆記錄代表一位委員（跨屆唯一），不是每屆任職紀錄。**

- 每位委員不論連任幾屆，只有一筆記錄
- `bioId` 跨屆固定，是跨資料集的關聯鍵
- `latestName` 是該委員最新屆期的姓名
- 這份資料集本身欄位極少，主要功能是給其他資料集「解碼 bioId」用

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `bioId` | keyword（_id） | 立委的唯一識別碼 |
| `latestName` | text（_name） | 最新屆期的委員姓名 |

### 關鍵欄位補充說明

| 欄位 | 型別 | 重要說明 |
|------|------|---------|
| `bioId` | keyword（_id） | 委員跨屆唯一識別碼；直接查單筆：`/records/{bioId}` |
| `latestName` | text（_name） | 最新屆期中文姓名；全文搜尋：`?q=王金平` |

> 兩個欄位均無 `filter: true`，/agg 端點對此資料集**無法使用**。

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records`

### 範例 1：已知 bioId，查委員姓名

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records/22"
```

用途：直接以 bioId 取得單筆記錄，最快速的查法。回應即含 `latestName`。

---

### 範例 2：已知姓名，查 bioId（全文搜尋）

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records?q=王金平"
```

用途：`q=` 全文搜尋 `latestName` 欄位，適合從姓名反查 bioId。若同名，回傳多筆。

---

### 範例 3：已知 bioId，用篩選參數查

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records?bioId=22"
```

用途：等同範例 1，但用 query 參數方式。適合需要統一格式的程式呼叫。

---

### 分頁查詢（列出所有委員）

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records?page=1&per_page=20"
```

回應中 `"total"` 欄位是符合條件的總筆數（共 772 筆）。

---

## 與 tw.gov.ly~ref~legislator-by-term-name 的搭配使用

**典型流程：從姓名找到跨屆資料**

1. 用本資料集的全文搜尋，從姓名取得 `bioId`
2. 帶著 `bioId`，到 `tw.gov.ly~ref~legislator-by-term-name` 查詢該委員所有屆次記錄

```bash
# 步驟 1：找 bioId
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records?q=王金平"
# 取得 bioId=22

# 步驟 2：查所有屆次記錄
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-by-term-name/records?bioId=22"
```

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.ly~ref~legislator-by-term-name`](../tw.gov.ly~ref~legislator-by-term-name/skill.md) | 委員歷屆任職記錄（每屆一筆，1,656 筆） | `bioId` 欄位對照本資料集；跨屆詳細資料的主要來源 |

---

## 注意事項與限制

1. **只有 2 個欄位**：本資料集僅供 bioId ↔ 姓名對照，無黨籍、選區等資訊，詳細資料需查歷屆名單。
2. **無 /agg 功能**：兩個欄位均無 `filter: true`，/agg 端點無可用 group_by 欄位。
3. **`latestName` 是最新姓名**：若委員曾改名，較早屆的姓名只存在歷屆名單的 `name` 欄位，本資料集不保留舊名。
4. **全文搜尋可能多筆**：同名委員（罕見）用 `q=姓名` 會回傳多筆，需再比對其他資訊確認。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 全文搜尋（姓名） | `?q=委員姓名` |
| bioId 精確篩選 | `?bioId=22`（或直接 `/records/22`） |
| 分頁 | `?page=1&per_page=20` |
| /agg | ❌ 不支援（無可分組欄位） |
| Records 回應 | JSON，含 `total`、`page`、`per_page`、`records[]` |