---
reviewed_by:
  rd: Ronny
  pm:
---
# 政府機關 OID 碼 — `tw.gov.moda~ref~oid`

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

---

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

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

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

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

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

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

---

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

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

- 「經濟部的 OID 是多少？」
- 「OID `2.16.886.101.20003.20007` 是哪個機關？」
- 「投資審議司的 OID 是什麼？」
- 「行政院底下的 OID 樹狀結構長什麼樣子？」
- 「這個 OID 對應到哪個 DGPA 機關代碼？」

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

- 「立法院公報處的 OID 是什麼？」（立法院多數下屬單位無 OID，僅資訊處有）
- 「這個機關是否已裁撤？」（需查 `tw.gov.dgpa~ref~gov-org` 的裁撤欄位）
- 「機關代碼 A13000000G 的歷史沿革為何？」（需查 `tw.gov.dgpa~ref~gov-org`）

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 數位發展部，維護於 oid.nat.gov.tw（原由國家發展委員會負責，數位發展部成立後移交） |
| 執行機構 | 中華電信股份有限公司（受數位發展部委託執行） |
| 更新頻率 | 按需更新 |
| 總筆數 | 約 7,986 筆（2026-05 查詢） |

---

## 欄位說明

> API 查詢時使用欄位名稱作為 query 參數名稱。

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `OID` | keyword（_id） | OID |
| `OrgName` | text（_name） | 機關名稱 |
| `OID.parent` | keyword（ref: tw.gov.moda~ref~oid） | 上層機關 OID |
| `TEL` | text | 電話號碼 |
| `Address` | text | 地址 |
| `DN` | text | DN 識別名稱 |
| `OrgCode` | keyword | 組織代碼 |

### 關鍵欄位補充說明

| 欄位 | 重要說明 |
|------|---------|
| `OID` | OID 字串，同時也是 API 記錄的 `_id`。格式：`2.16.886.101.XXXXX`，以點分隔，代表層級 |
| `OrgName` | 機關或單位名稱 |
| `OrgCode` | 對應的 DGPA 機關代碼（可連結 `tw.gov.dgpa~ref~gov-org`）。**注意：同一 OrgCode 可能對應多個 OID**（沒有獨立機關代碼的司、處等單位與上級機關共用） |
| `DN` | LDAP Distinguished Name，格式如 `ou=投資審議司,ou=經濟部,o=行政院,c=TW`，可看出完整機關層次 |

---

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

### ⚠️ 同一 OrgCode 可能對應多筆 OID

`OrgCode` 是對應 DGPA 機關代碼的欄位，但**一個 OrgCode 可能有多筆 OID**。沒有獨立 DGPA 代碼的「單位」（司、處等）在 OID 系統中有自己的 OID，但 `OrgCode` 與上級機關相同。

查詢 `?OrgCode=A13000000G` 時會同時回傳經濟部本身與其下屬各司的 OID。若要找「機關本身的 OID」（最短的），請以 `OID` 字串長度或 `DN` 欄位內容判斷。

### ⚠️ OID 並非所有機關都有

部分機關在 OID 系統中完全缺席（例如立法院大多數下屬單位）。查無結果不代表機關不存在，可改查 `tw.gov.dgpa~ref~gov-org`。

### OID 中的點（`.`）在 URL 路徑中無需 encode

`GET .../records/2.16.886.101.20003.20007` 可直接使用，點號不需轉為 `%2E`。

---

## API 呼叫範例

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

### 依機關名稱搜尋 OID

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moda~ref~oid/records?q=經濟部&per_page=10"
```

---

### 依 OID 直接取得單筆記錄

```bash
# 取得行政院 OID
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moda~ref~oid/records/2.16.886.101.20003"

# 取得經濟部 OID
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moda~ref~oid/records/2.16.886.101.20003.20007"

# 取得投資審議司 OID（注意：OrgCode 與經濟部相同）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moda~ref~oid/records/2.16.886.101.20003.20007.20143"
```

---

### 透過 DGPA 機關代碼查詢對應 OID

```bash
# 查詢 OrgCode = A13000000G 的所有 OID（可能多筆）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moda~ref~oid/records?OrgCode=A13000000G&per_page=20"
```

⚠️ 同一 `OrgCode` 可能對應多筆 OID（機關本身 + 其下無獨立代碼的單位），請確認 `DN` 欄位以判斷是哪個層級的機關。

---

### 反向查詢：從 OID 找 DGPA 機關代碼

取得記錄後，`OrgCode` 欄位即為對應的 DGPA 機關代碼，可帶入 `tw.gov.dgpa~ref~gov-org` 查詢完整資訊。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.dgpa~ref~gov-org`](../tw.gov.dgpa~ref~gov-org/skill.md) | 人事總處機關代碼 | `OrgCode` 欄位對應到此資料集的 `機關代碼`，可查詢機關詳情、裁撤狀態、改制歷程 |

---

## 注意事項與限制

1. **OID 覆蓋範圍不完整**：並非所有政府機關與單位都有 OID。已確認的主要空白：立法院公報處、議事處、國會圖書館、各委員辦公室等均無 OID（立法院底下的 OID 只有 2 筆：立法院本身與資訊處）。

2. **同一 OrgCode 可能對應多個 OID**：沒有獨立 DGPA 機關代碼的「單位」（如司、處）在 OID 系統中可能有自己的 OID，但 `OrgCode` 與上級機關共用。查詢時若要找「該機關本身的 OID」（而非下屬單位），應核對 `DN` 欄位或 `OID` 的長度（越短越上層）。

3. **OrgCode 反映現行代碼**：機關改制後，OID 的 `OrgCode` 更新為新代碼。例如經濟部 OID 的 `OrgCode` 為 `A13000000G`（改制後），而非舊代碼 `313000000G`。

4. **OID 不是國際通用標準**：台灣使用的 `2.16.886.101.` 前綴中，`886` 是葉門的 ISO 國碼，並非台灣，此 OID 不被國際 OID 機構承認。但在台灣境內的電子公文、數位憑證系統中仍廣泛使用。

5. **原始資料品質問題**：oid.nat.gov.tw 中部分記錄存在 `OrgCode` 配對錯誤的情況（如某些組織的 OID 對應到不符的機關代碼），歐噴資料庫目前直接使用原始資料，未做校正。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moda~ref~oid/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 依名稱搜尋 | `?q=機關名稱` |
| 依 OID 精確查詢 | GET `.../records/{OID}`（點號可直接帶入，無需 encode） |
| 依 DGPA 代碼查 | `?OrgCode={機關代碼}`（可能回傳多筆，以 `DN` 判斷層級） |
| 分頁 | `?page=1&per_page=20` |
| Records 回應格式 | JSON，含 `total`、`page`、`per_page`、`records[]` |