Taxon API 2.5.3版即刻推出，本版本僅作小幅度修改，部分欄位將於2.6版移除，請使用本API者先行準備。細部更動見於文件中。

簡介

本文件由農業部生物多樣性研究所編製，描述所屬台灣生物多樣性網絡（Taiwan Biodiversity Network，TBN）之物種（taxon）開放API規格。

服務類型

本API提供查詢TBN物種之服務。

查詢參數

參數型態

• UUID：字串，RFC 4122，需含斷字符號共36個字元
• 文字
• 列舉

taxonGroup代碼表

nativeness代碼表

protectedStatusTW代碼表

categoryRedlistTW代碼表

categoryIUCN代碼表

複合查詢

各查詢參數均可做聯集查詢。如以下網址查詢"哺乳類"中"台灣特有種"的物種

https://www.tbn.org.tw/api/v25/taxon?taxonGroup=哺乳類&endemism=taiwan

回傳範例：

{
    "meta": {
        status: "SUCCESS",
        total: 54,
        itemsCount: 54,
        generateDate: "2022-03-08T15:20:43+08:00"
    },
    "links": {
        self: "https://www.tbn.org.tw/api/v25/taxon?taxonGroup=%E5%93%BA%E4%B9%B3%E9%A1%9E&endemism=%E5%8F%B0%E7%81%A3%E7%89%B9%E6%9C%89",
        next: ""
    },
    "data": [
        {
            "taxonUUID": "59e4538f-605e-4f8a-954d-6695df1d6fdc",
            "parentUUID": "5ab0f210-087a-4534-a089-963de6dc55e9",
            "taxonName": "短尾鼩 Anourosorex yamashinai",
            "scientificName": "Anourosorex yamashinai",
            "vernacularName": "短尾鼩",
            "simplifiedScientificName": "Anourosorex yamashinai",
            "taxonRank": "種",
            "class": "Mammalia",
            "family": "Soricidae",
            "taxonGroup": "哺乳類",
            "endemism": "台灣特有",
            "nativeness": "原生 Native",
            "protectedStatusTW": null,
            "categoryRedlistTW": "暫無危機（LC, Least Concern）",
            "categoryIUCN": "暫無危機（LC, Least Concern）",
            "sensitiveCategory": null,
            "taiColNameCode": "t0071669",
            "taiCOLTaxonID": "t0071669",
            "tfNameCode": null,
            "children": null
        },
        ...
    ]
}

查詢特定參數，加上withChildren，釋出下一階子分類群資料將會填入"children"欄位

https://www.tbn.org.tw/api/v25/taxon?name=麻雀&withChildren=1

回傳範例：

{
    "meta": {
        status: "SUCCESS",
        total: 8,
        itemsCount: 8,
        generateDate: "2022-03-08T15:20:43+08:00"
    },
    "links": {
        self: "https://www.tbn.org.tw/api/v25/taxon?name=%E9%BA%BB%E9%9B%80&withChildren=1",
        next: ""
    },
    "data": [
        {
            "taxonUUID": "1eda1fcc-84c0-4065-a530-71d362fb6b30",
            "parentUUID": "18d524d4-ac32-4db7-b59f-e008efb3b52a",
            "taxonName": "麻雀科 Passeridae"",
            "scientificName": "Passeridae",
            "vernacularName": "麻雀科",
            "simplifiedScientificName": "Passeridae",
            "taxonRank": "科",
            "class": "Aves",
            "family: "Passeridae",
            "taxonGroup": "鳥",
            "endemism": null,
            "nativeness": null,
            "protectedStatusTW": null,
            "categoryRedlistTW": null,
            "categoryIUCN": null,
            "sensitiveCategory": null,
            "taiColNameCode": null,
            "tfNameCode": null,
            "children": [
                {
                     "taxonUUID": "c1975a33-1bd1-4b3b-8e53-a7be6a74852a",
                     "parentUUID": "1eda1fcc-84c0-4065-a530-71d362fb6b30",
                     "taxonName": "麻雀屬 Passer",
                     "scientificName": "Passer",
                     "vernacularName": "麻雀屬",
                     "simplifiedScientificName": "Passer",
                     "taxonRank": "屬",
                     "class": "Aves",
                     "family": "Passeridae",
                     "taxonGroup": "鳥",
                     "endemism": null, 
                     "nativeness": null, 
                     "protectedStatusTW": null, 
                     "categoryRedlistTW": null, 
                     "categoryIUCN": null, 
                     "sensitiveCategory": null, 
                     "taiColNameCode": null, 
                     "tfNameCode": null, 
                     "children": null
               }
            ]
        },
        ...
    ]
}

資料欄位

JSON欄位名

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

資料型態與允許值

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

回傳欄位表

taxonRank分類階層表