---
reviewed_by:
  rd: Ronny
  pm:
---
# `tw.gov.moj~ref~law` — 全國法規資料庫

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

---

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

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

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records?q=預算法&per_page=5"

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

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

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

**回應使用者時須附原始單筆查詢 URL** — 讓使用者可驗證 agent 回答內容：
將紀錄之 `LawID` 值代入：`https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode={LawID}`
例：紀錄 `LawID=D0020049` → `https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode=D0020049`（政治獻金法現行條文，法務部全國法規資料庫官方頁）

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 法務部全國法規資料庫（law.moj.gov.tw） |
| 更新頻率 | 不定期（隨法規修訂即時更新） |
| 總筆數 | 約 8,997 筆（含已廢止法規） |
| 現行有效 | 約 5,932 筆（`LawAbandonNote` 為空） |

---

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

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

- 「預算法第2條的條文是什麼？」
- 「現行（未廢止）的財政相關法律有哪些？」
- 「某法律的完整條文與沿革」
- 「搜尋包含某關鍵字的法規條文」

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

- 「司法解釋、判例」（只含法規條文，不含判決）
- 「地方自治條例」（以中央法規為主）
- 「條文修正草案」（只含現行或已廢止版本）

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `LawID` | keyword（_id） | 法規代碼 |
| `LawLevel` | keyword（篩選器） | 法規位階 |
| `LawName` | text（_name） | 法規名稱 |
| `LawURL` | text | 法規網址 |
| `LawCategory` | keyword（篩選器） | 法規類別 |
| `LawModifiedDate` | date | 法規異動日期 |
| `LawEffectiveDate` | date | 法規生效日期 |
| `LawEffectiveNote` | text | 法規生效內容 |
| `LawAbandonNote` | keyword（篩選器） | 廢止註記 |
| `LawHasEngVersion` | boolean | 是否英譯註記 |
| `EngLawName` | text | 英文法規名稱 |
| `LawAttachements` | object（多值） | 附件 |
| `LawHistories` | text | 沿革內容 |
| `LawForeword` | text | 前言 |
| `LawArticles` | text | 法規條文 |

### 關鍵欄位補充說明

| 欄位 | 型別 | 重要說明 |
|------|------|---------|
| `LawID` | keyword（_id） | 法規代碼，格式：英文字母 + 7 碼數字，如 `T0020001`（預算法）；可組出原始網址（見下方） |
| `LawName` | text（_name） | 法規名稱；欄位指定搜尋：`?q[LawName]=預算法` |
| `LawAbandonNote` | keyword（篩選器） | **`''`（空字串）= 現行有效**；`'廢'` = 已廢止；務必過濾 |
| `LawLevel` | keyword（篩選器） | 法規位階：`法律`、`命令` |
| `LawCategory` | keyword（篩選器） | 主管機關名稱；廢止法規格式為 `廢止法規＞{機關}` |
| `LawArticles` | text | 完整條文（純文字，各條換行分隔）；全文搜尋：`?q=關鍵字` |
| `LawHistories` | text | 修訂沿革（歷次修訂日期、令號、內容） |
| `LawModifiedDate` | date | 最後異動日期（YYYY-MM-DD） |

---

## 溯源原始網址

取得法規資料後，可用 `LawID` 組出全國法規資料庫的官方頁面連結供使用者點閱：

```
https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode={LawID}
```

例：預算法（`T0020001`）→ `https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode=T0020001`

若使用者想確認條文原文或查看更多資訊，可提供此連結直接連到政府官方頁面。

---

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

### ⚠️ 預設查詢包含已廢止法規

不加篩選時，已廢止法規（`LawAbandonNote = '廢'`，約 3,065 筆）會混入結果。若只需現行有效法規：

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records?LawAbandonNote=&per_page=20"
```

### ⚠️ `?q=` 全文搜尋涵蓋條文全文

`?q=歲入` 會同時搜尋法規名稱與所有條文內容。若只想搜尋**法規名稱**，改用：

```bash
?q[LawName]=預算法
```

### LawCategory 廢止法規前綴

廢止法規的類別格式為 `廢止法規＞{主管機關}`。`?LawCategory=財政部` 只會找現行有效財政部法規；若需含廢止，改用 `?q[LawCategory]=財政部`。

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records`

### 搜尋特定法規名稱

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records?q[LawName]=預算法&per_page=5"
```

### 依法規代碼直接取得單筆

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records/T0020001"
```

### 只查現行有效法規

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records?LawAbandonNote=&per_page=20"
```

### 全文搜尋條文內容

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records?q=歲入&per_page=10"
```

### 依法規位階篩選

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records?LawLevel=法律&LawAbandonNote=&per_page=20"
```

### 依主管機關篩選

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records?LawCategory=財政部&per_page=20"
```

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.openfun~api~legislation`](../tw.openfun~api~legislation/skill.md) | 立法院議事資料 | 查詢法案審議過程、立委質詢等，與本資料集的條文互補 |

---

## 注意事項與限制

1. **廢止法規仍存在**：未加 `?LawAbandonNote=` 時，已廢止法規也會出現在結果中。
2. **LawArticles 為完整條文文字**：純文字，各條以換行分隔；已刪除條文保留「（刪除）」字樣。
3. **LawID 格式**：字母開頭 + 7 位數字，如 `T0020001`（預算法）。
4. **地方法規不含**：本資料集以中央法規為主，直轄市、縣市自治條例不在範圍內。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moj~ref~law/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 依名稱搜尋 | `?q[LawName]=預算法` |
| 依代碼精確查詢 | GET `.../records/{LawID}` |
| 溯源官方頁面 | `https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode={LawID}` |
| 只查現行有效 | `?LawAbandonNote=`（空字串） |
| 全文搜尋條文 | `?q=關鍵字` |
| 依位階篩選 | `?LawLevel=法律` 或 `?LawLevel=命令` |
| 依主管機關篩選 | `?LawCategory=財政部` |
| 分頁 | `?page=1&per_page=20` |
| Records 回應格式 | JSON，含 `total`、`page`、`per_page`、`records[]` |