TaiCoL API version 1.0 說明文件 - HackMD

TaiCoL API version 1.0 說明文件

tags: TaiCoL

本API服務網址為:http://api.taicol.tw/{version}/?{parameters}

🁢 API參數說明

查詢參數 說明 範例網址
namecode={string} 取得指定學名編碼的學名資料 http://api.taicol.tw/v1/?namecode=201121
speciesname={string} 取得部分符合輸入物種學名的學名資料 http://api.taicol.tw/v1/?speciesname=Morus
common={string} 取得部分符合輸入中文俗名的學名資料 http://api.taicol.tw/v1/?common=山柑
date={yyyy-mm-dd} 取得指定年月日以後更新之學名資料 http://api.taicol.tw/v1/?date=2020-12-01
accept={True/False} 取得有效/無效之學名資料 http://api.taicol.tw/v1/?accept=True
simple={True/False} 取得簡略與否的資料 http://api.taicol.tw/v1/?simple=True

🁢 格式、每頁筆數與分頁

參數 說明 範例網址
limit 限制每頁回傳筆數,預設200筆 http://api.taicol.tw/v1/?simple=True&limit=5
page 輸入瀏覽分頁數 http://api.taicol.tw/v1/?speciesname=Carex&limit=5&page=2

🁢 以學名編碼查詢

🁢 以物種學名查詢

🁢 以物種中文俗名查詢

🁢 查詢指定日期以後更新的學名資料

🁢 查詢接受名/非接受名的學名資料

🁢 查詢簡略版的學名資料

🁢 回傳欄位說明

欄位 說明 備註
name_code 學名編碼
name 學名(拉丁名)
genus
species
infraspecies_marker 種下階層名
infraspecies 種下名
infraspecies2_marker 種下下階層名
infraspecies2 種下下名
author 學名命名者
author2 學下名命名者
is_accepted_name 是否為有效名 1:是, 2:否
accepted_name_code 有效學名的學名編碼
status_id 學名狀態 0:種階層名, 1:有效學名, 2:歧義異名, 3:鑑定錯誤, 5:同種異名, 8:字尾變異, 9:次同種異名, 10:屬名變動, 11:原始學名, 12:拼法錯誤, 13:錯誤紀錄/無效名
is_endemic 是否為臺灣特有種 1:是, 2:否
alien_status 外來屬性 0:原生, 1:歸化, 2:入侵本地, 3:入侵他地, 4:栽培/豢養, 5:排除/疑問
is_marine 是否為海洋種 1:是, 2:否
is_fossil 是否為化石種 1:是, 2:否
ref_short 相關文獻(簡短)
reference 相關文獻
comment 附註
datelastmodified 最後更新日期
kingdom
kingdom_c 界中文名
phylum
phylum_c 門中文名
class
class_c 綱中文名
order
order_c 目中文名
family
family_c 科中文名
genus_c 屬中文名
common_name_c 中文俗名
iucn_code 國際自然保育聯盟(IUCN)紅皮書瀕危等級
cites_code 華盛頓公約(CITES)附錄號 1:附錄I, 2:附錄II, 3:附錄III
coa_redlist_code 法定保育類野生動物保育等級
redlist_tw_2017 臺灣紅皮書名錄瀕危等級(2017)
redlist_wang 臺灣維管束植物紅皮書初評名錄瀕危等級(2012)
redlist_chen 臺灣淡水魚紅皮書瀕危等級(2012)

🁢 使用規範

本API採「政府資料開放授權條款」