台灣生物多樣性網絡

台灣生物多樣性網絡 (Taiwan Biodiversity Network, TBN) 資料介接API及使用說明

TBN 提供開放API，讓使用者可以透過程式設計方式查詢與取得TBN資料。本API為公開服務，對所有人開放，惟請注意：

為保護敏感物種，資料進行了必要的模糊化處理，若使用者有取得未模糊化資料之需求，可申請限制型 API。
為保護個人隱私，資料內未含有觀測者個人資料。
API目的為供機器間自動處理，非供直接閱讀。

授權條款

開放API採「政府資料開放授權條款」授權公眾使用。

API基本架構

介接方式

本API為僅使用HTTP GET protocol 的 RESTful API。

服務網址

本API的一般性服務網址為 https://www.tbn.org.tw/api/{version}/{type}?{parameters} ，其中：

{version}: API版本，本版本為v2.6，於網址中寫為v26。
{type}: API服務類型，包括occurrence、taxon與dataset。
{parameters}: 查詢參數。

API服務類型

本API提供三種服務類型：

觀測紀錄查詢 occurrence

本類型提供TBN收錄觀測記錄查詢。本服務會進行部分資訊模糊化，如果你有取得模糊化資料之需求，請申請限制性API服務。

物種查詢 taxon

本類型提供TBN物種資料庫查詢服務。透過本類型服務，可以物種名（含別名）關鍵字及TBN物種UUID查詢TBN物種（含高階分類群）。本類型取得之資訊，如TBN物種UUID，可用於觀測紀錄查詢。

資料集查詢 dataset

本類型提供TBN收錄資料集查詢服務。透過本類型服務，可以資料集標題關鍵字及TBN資料集UUID取得TBN資料集資訊。本類型取得之資訊，如TBN資料集UUID，可用於觀測紀錄查詢。

分頁與筆數限制

因效能考量，本API限制單一請求至多回傳1000筆資料（預設為300），你可以透過分頁參數limit設定回傳資料數。

每次API取得之資料中，如有下一分頁資料，會包含取得下一分頁之網址，可用該網址遞迴取得全部資料。

回傳格式

本API均回傳JSON結果物件（Object），其回傳格式為：

{
    "meta": {
      "status": "SUCCESS",
      "total": (int)符合查詢條件全部筆數,
      "generateDate": 本次請求時間,
    },
    "links": {
      "self": (string)本頁網址,
      "next": (string)下一分頁網址
    },
    "data": (Array) [結果陣列],
}

後續發展

TBN API以開放並盡可能釋出原始資料為目標。對本API有任何建議，請不吝告訴我們。

API修改歷程紀錄

2026.7.9 API v2.6 啟用
2022.3.14 API v2.5 啟用
2020.6.22 API v2.01 啟用
2020.1.1 API v2.0 啟用
2018.12 API v1.0上線

Taiwan Biodiversity Network

TBN API v2.6