Dataset API v26

簡介

本文件描述台灣生物多樣性網絡(Taiwan Biodiversity Network,TBN)資料集(dataset)開放API規格。

 

查詢參數

參數型態

  • UUID:字串,RFC 4122,需含斷字符號共36個字元
  • 時間:字串,格式為西元10碼+24小時制精度至分之5碼格式,即YYYY-MM-DD HH:MM,台灣時區
  • 文字

參數名

參數中文名

型態

說明

範例網址

UUID

資料集UUID

UUID

TBN資料集UUID

https://www.tbn.org.tw/api/v26/dataset?uuid=248d6799-bb66-40a5-b7ba-b45bbb818ddc

name

資料集名

文字

支援部分查詢

https://www.tbn.org.tw/api/v26/dataset?name=tbn

modified

最後修改時間

時間

格式 YYYY-MM-DD HH:II,包含指定時間後詮釋資料有修改的資料集

https://www.tbn.org.tw/api/v26/dataset?modified=2026-02-10 23:00

 

複合查詢

各查詢參數均可做聯集查詢。如以下網址查詢資料集名稱包含"tbn"中詮釋資料最後修改時間為"2026年2月17日晚上11:00"的資料集

https://www.tbn.org.tw/api/v26/dataset?name=tbn&modified=2026-02-17 23:00

回傳範例:

{
  "meta": {
    "status": "SUCCESS",
    "total": 8,
    "generateDate": "2026-07-01T05:10:39+00:00",
    "access_level": 0
  },
  "links": {
    "self": "https://www.tbn.org.tw/api/v26/dataset?modified=2026-02-17%2023%3A00&name=tbn",
    "next": ""
  },
  "data": [
    {
      "datasetName": "TBN-DP 台灣爬行類回報:隨機回報",
      "datasetTaxonGroup": "爬行類",
      "datasetLicense": "政府資料開放授權條款-第1版",
      "datasetPublisher": "農業部生物多樣性研究所",
      "datasetAuthor": "林德恩、陳昱凱、陳惇聿、倪旻萱、郭貴嵐",
      "datasetUUID": "e1b7adf8-9315-4134-aced-729a09da40f6",
      "datasetURL": "/dataset/e1b7adf8-9315-4134-aced-729a09da40f6",
      "datasetDataFrom": "TBN研管中心",
      "GBIFdatasetkey": NULL,
      "datasetMetadataLastModified": "2026-06-30T17:30:01Z",
      "datasetDateCoverage": "2003-08-11 ~ 2026-06-23",
      "occurrenceCount": 16506
    },
    ...
  ]
}

 

資料欄位

JSON欄位名

  • 欄位名 (JSON field name) 均為羅馬字英文字母,大小寫不同,範圍為[a-zA-Z]。
  • 欄位名命名採首字小寫駝峰式 (Camel) 命名法。

資料型態與允許值

  • UUID:字串,RFC 4122,需含斷字符號共36個字元
  • 文字
  • 列舉:為規定值之一
  • 允許多值時,多值以半形分號;分隔
  • 無資料時回傳null

回傳欄位表

API欄位名

中文欄位名

型態

值與說明

datasetName

資料集名

文字

 

datasetTaxonGroup

含括類群

文字

 

datasetLicense

授權

列舉

[CC0, CC BY, CC BY-NC, OGDL-Taiwan-1.0]

datasetPublisher

發布者

文字

資料集發布單位

datasetAuthor

作者

文字

資料集作者

datasetUUID

資料集UUID

UUID

TBN資料集UUID

datasetURL

網址

文字

URL

datasetDataFrom

資料來源

文字

 

GBIFdatasetkey

GBIFdatasetkey

UUID

 

datasetMetadataLastModified

最後修改時間

時間

YYYY-MM-DD HH:MM

datasetDateCoverage

含括時間

文字

精度至日

occurrenceCount

觀測紀錄數

數字