---
reviewed_by:
  rd: Ronny
  pm: Zoe
---
# `tw.gov.cec~ref~election-type` — 投票種類代碼表

> **給 AI 閱讀的資料集說明。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.cec~ref~election-type 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

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

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

最簡查詢範例：`curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-type/records"`

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請先請使用者前往 https://data.openfun.tw/user 申請。

禁止抓取 HTML 頁面（本平台有 bot 保護）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／中央選舉委員會」

---

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

**可以回答：**
- 「`RCL` 是什麼種類的投票？」
- 「所有投票種類代碼有哪些？」

**無法回答：**
- 「有哪些補選（BEL）？」（請查 `tw.gov.cec~ref~election-event`）
- 「罷免的投票結果？」（請查 [`tw.gov.cec~txn~votes-geo`](../tw.gov.cec~txn~votes-geo/skill.md)）

---

## 欄位說明

| 欄位名稱 | 型別 | 說明 |
|---------|------|------|
| `id` | keyword（_id） | 種類代碼，如 `ELC`、`RCL` |
| `name` | text（_name） | 種類名稱，如 `選舉`、`罷免` |

---

## 完整代碼清單（4 筆）

| `id` | `name` | 說明 |
|------|--------|------|
| `ELC` | 選舉 | 一般定期選舉 |
| `BEL` | 補選 | 職缺補行選舉 |
| `RCL` | 罷免 | 選民發動之罷免投票 |
| `REF` | 公投 | 公民投票（議題，非人事） |

---

## 查詢範例

```bash
# 取出全部 4 筆（無需篩選，資料量極小）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-type/records"

# 查特定代碼
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-type/records?id=RCL"
```

---

## 注意事項

1. **共 4 筆，全部取出即可**：資料量極小，不需分頁或篩選
2. **本表是 reference**：本身不含選舉活動資訊，實際搭配 `tw.gov.cec~ref~election-event` 使用，透過 `vote_type_id` 欄位對應
3. **公投（REF）無對應的選舉層級**：公投不涉及人事選舉，`vote_level_id` 在公投場次可能為空或特殊值

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.cec~ref~election-event`](../tw.gov.cec~ref~election-event/skill.md) | 歷次投票事件 | `vote_type_id` 欄位引用本表 `id` |
| [`tw.gov.cec~ref~election-level`](../tw.gov.cec~ref~election-level/skill.md) | 選舉層級代碼 | 搭配使用：總統/立委/縣市長等 |
| [`tw.gov.cec~ref~candidates`](../tw.gov.cec~ref~candidates/skill.md) | 候選人資料 | 透過 election-event 間接關聯 |
| [`tw.gov.cec~txn~votes-geo`](../tw.gov.cec~txn~votes-geo/skill.md) | 投票概況／結果 | 罷免、公投投票結果 |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-type/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 總筆數 | 4（靜態） |
| 主鍵 | `id` |
| 篩選器欄位 | `id` |
| 更新頻率 | 靜態 |
| 來源 | 中央選舉委員會 |