[更新] Eco API - 區域物種名錄查詢端點
發佈日期：2026-07-10 | 最後更新：2026-07-10 | API版本：v1.8
ODB Eco API 更新至版本 1.8，新增與異動如下：
1.更新區域物種名錄查詢端點 /bio/checklist
舊版區域物種名錄查詢端點（method為GET）已於v1.8停用；新版端點method改為POST接續提供服務。
新版端點回傳的物種名錄資料，不再限於原始出現紀錄的分類層級，將會把其父階層類群一併提供。例如，原始出現紀錄鑑定至種，舊版僅會提供該「種」類群；新版則會將其父階層（界、門、綱…等）類群資訊完整提供，每筆類群資料亦新增基礎７階層欄位（kingdom, phylum, class, order, family, genus, species）。另外，舊版參數author、open不再提供服務；原參數poly改為geo，且僅接受WKT格式，可輸入單一或多個多邊形區域進行查詢（POLYGON或MULTIPOLYGON）。
Request
curl -X 'POST' \
'https://api.odb.ntu.edu.tw/ecoapi/bio/checklist' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"rank": "family",
"geo": "POLYGON((119.2 23.5, 119.2 23.3, 119.7 23.3, 119.7 23.5, 119.2 23.5))"
}'{
"checklist": [
{
"AphiaID": 106730,
"parentNameUsageID": 106684,
"scientificName": "Luciferidae",
"chineseName": "瑩蝦科",
"taxonRank": "family",
"taxonRankID": 140,
"kingdom": "Animalia",
"phylum": "Arthropoda",
"class": "Malacostraca",
"order": "Decapoda",
"family": "Luciferidae",
"genus": null,
"species": null
},
{
"AphiaID": 105689,
"parentNameUsageID": 10210,
"scientificName": "Carcharhinidae",
"chineseName": "真鯊科",
"taxonRank": "family",
"taxonRankID": 140,
"kingdom": "Animalia",
"phylum": "Chordata",
"class": "Elasmobranchii",
"order": "Carcharhiniformes",
"family": "Carcharhinidae",
"genus": null,
"species": null
},
...
{
"AphiaID": 219959,
"parentNameUsageID": 205726,
"scientificName": "Takifugu oblongus",
"chineseName": "橫紋多紀魨",
"taxonRank": "species",
"taxonRankID": 220,
"kingdom": "Animalia",
"phylum": "Chordata",
"class": "Teleostei",
"order": "Tetraodontiformes",
"family": "Tetraodontidae",
"genus": "Takifugu",
"species": "Takifugu oblongus"
}
],
"taxonCount": {
"kingdom": 1,
"phylum": 2,
"class": 4,
"order": 42,
"family": 132,
"genus": 298,
"species": 457,
"total_taxon": 932
},
"metadata": {
"timeStamp": "DD/MM/YYYY, HH:MM:SS",
"bibliographicCitation": "Ocean Data Bank, National Science and Technology Council, Taiwan. https://doi.org/10.5281/zenodo.7512112. Accessed DD/MM/YYYY from Ocean Data Bank. https://api.odb.ntu.edu.tw/ecoapi.",
"originalCitationList": [
"Ocean Data Bank, National Science and Technology Council, Taiwan. https://doi.org/10.5281/zenodo.7512112.",
...
]
}
}
English 
Chinese