TaiCoL API version 1.0 說明文件

page update: 2021/01/18

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

🁢 API參數說明

• 以上參數可相互組合，如：
  http://api.taicol.tw/v1/?speciesname=Carex&date=2020-01-01&accept=True&simple=True

🁢 格式、每頁筆數與分頁

• 本API回傳格式為JSON。
• 分頁參數說明：

• 回傳格式：

      {
          "total_page": 1,
          "current_page": 1
      },
      {結果},
      ......
  

🁢 以學名編碼查詢

• 查詢條件：namecode={string}
• 說明：以學名編碼為查詢條件，回傳「完全符合」查詢條件者。
• 範例：
  • 服務網址：http://api.taicol.tw/v1/?namecode=201121
  • 說明：找學名編碼為「201121」的學名資訊。
  • 回傳：

    {
        "name_code": "201121",
        "name": "Taiwania cryptomerioides",
        "genus": "Taiwania",
        "species": "cryptomerioides",
        "infraspecies_marker": null,
        "infraspecies": null,
        "infraspecies2_marker": null,
        "infraspecies2": null,
        "author": "Hayata",
        "author2": null,
        "is_accepted_name": 1,
        "accepted_name_code": "201121",
        "status_id": 1,
        "is_endemic": 1,
        "alien_status": 0,
        "is_marine": null,
        "is_fossil": 0,
        "ref_short": "Flora of Taiwan 2nd ed. 1: 584, 1994",
        "reference": "Flora of Taiwan 2nd ed. 1: 584, 1994. J. Linn. Soc., Bot. 37(260): 330-331, pl. 16, 1906. Flora of Taiwan 1: 532, pl. 189, 1975. Fl. Reip. Pop. Sin. 7: 292, pl. 67, f. 12-17, 1978.",
        "comment": null,
        "datelastmodified": "2009-10-29",
        "kingdom": "Plantae",
        "kingdom_c": "植物界",
        "phylum": "Tracheophyta",
        "phylum_c": "維管束植物門",
        "class": "Pinopsida",
        "class_c": "松綱",
        "order": "Cupressales",
        "order_c": "柏目",
        "family": "Cupressaceae",
        "family_c": "柏科",
        "genus_c": "臺灣杉屬",
        "common_name": "臺灣杉",
        "alternative_name_c": "臺灣爺;亞杉;台灣杉;台灣爺",
        "iucn_code": "VU",
        "cites_code": null,
        "coa_redlist_code": null,
        "redlist_tw_2017": "EN",
        "redlist_wang": "EN",
        "redlist_chen": null
    }
  

🁢 以物種學名查詢

• 查詢條件：speciesname={string}
• 說明：以物種屬名或最簡學名(不含命名者)為查詢條件，回傳符合查詢條件的所有資料。輸入區分大小寫，屬名與種小名間以半形空格符號(%20)區隔。
• 範例：
  • 服務網址：http://api.taicol.tw/v1/?speciesname=Morus
  • 說明：找物種學名包含「Morus」的學名資訊。
  • 回傳：

    {
        "name_code": "204873",
        "name": "Morus australis",
        "genus": "Morus",
        "species": "australis",
        "infraspecies_marker": null,
        "infraspecies": null,
        "infraspecies2_marker": null,
        "infraspecies2": null,
        "author": "Poir.",
        "author2": null,
        "is_accepted_name": 1,
        "accepted_name_code": "204873",
        "status_id": 1,
        "is_endemic": 0,
        "alien_status": 0,
        "is_marine": null,
        "is_fossil": 0,
        "ref_short": "Flora of Taiwan 2nd ed. 2: 194, 1996",
        "reference": "Flora of Taiwan 2nd ed. 2:194, 1996",
        "comment": null,
        "datelastmodified": "2009-01-09",
        "kingdom": "Plantae",
        "kingdom_c": "植物界",
        "phylum": "Tracheophyta",
        "phylum_c": "維管束植物門",
        "class": "Magnoliopsida",
        "class_c": "木蘭綱",
        "order": "Rosales",
        "order_c": "薔薇目",
        "family": "Moraceae",
        "family_c": "桑科",
        "genus_c": "桑屬",
        "common_name": "小桑樹",
        "alternative_name_c": null,
        "iucn_code": null,
        "cites_code": null,
        "coa_redlist_code": null,
        "redlist_tw_2017": "LC",
        "redlist_wang": null,
        "redlist_chen": null
    }
  

🁢 以物種中文俗名查詢

• 查詢條件：common={string}
• 說明：以物種中文俗名為查詢條件，回傳「部分符合」查詢條件的所有資料。
• 範例：
  • 服務網址：http://api.taicol.tw/v1/?common=山柑
  • 說明：找中文俗名包含「山柑」的學名資訊。
  • 回傳：

    {
        "name_code": "202622",
        "name": "Capparis sikkimensis formosana",
        "genus": "Capparis",
        "species": "sikkimensis",
        "infraspecies_marker": "subsp.",
        "infraspecies": "formosana",
        "infraspecies2_marker": null,
        "infraspecies2": null,
        "author": "Kurz",
        "author2": "(Hemsl.) Jacobs",
        "is_accepted_name": 1,
        "accepted_name_code": "202622",
        "status_id": 1,
        "is_endemic": 0,
        "alien_status": 0,
        "is_marine": null,
        "is_fossil": 0,
        "ref_short": "Flora of Taiwan 2nd ed. 2: 738, 1996",
        "reference": "Flora of Taiwan 2nd ed. 2: 738, 1996",
        "comment": null,
        "datelastmodified": "2009-01-09",
        "kingdom": "Plantae",
        "kingdom_c": "植物界",
        "phylum": "Tracheophyta",
        "phylum_c": "維管束植物門",
        "class": "Magnoliopsida",
        "class_c": "木蘭綱",
        "order": "Brassicales",
        "order_c": "十字花目",
        "family": "Capparaceae",
        "family_c": "山柑科",
        "genus_c": "山柑屬",
        "common_name": "山柑",
        "alternative_name_c": null,
        "iucn_code": null,
        "cites_code": null,
        "coa_redlist_code": null,
        "redlist_tw_2017": "CR",
        "redlist_wang": "CR",
        "redlist_chen": null
    },
    ......
  

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

• 查詢條件：date={yyyy-mm-dd}
• 說明：輸入特定年、月、日之日期，回傳指定日期之後更新的所有學名資料。可與前述其他查詢參數組合使用。
• 範例：
  • 服務網址：http://api.taicol.tw/v1/?speciesname=Carex&date=2020-09-01
  • 說明：找物種學名包含「Carex」，並在2020-09-01後更新的學名資訊。
  • 回傳：

    {
        "name_code": "201237",
        "name": "Carex ligulata glabriutriculata",
        "genus": "Carex",
        "species": "ligulata",
        "infraspecies_marker": "var.",
        "infraspecies": "glabriutriculata",
        "infraspecies2_marker": null,
        "infraspecies2": null,
        "author": "Nees, 1834",
        "author2": "Q.S. Wang",
        "is_accepted_name": 1,
        "accepted_name_code": "201237",
        "status_id": 1,
        "is_endemic": 0,
        "alien_status": 0,
        "is_marine": null,
        "is_fossil": 0,
        "ref_short": "Flora of Taiwan 2nd ed. 5: 216, 2000",
        "reference": "Flora of Taiwan 2nd ed. 5: 216, 2000.; Journal of Wuhan Botanical Research 5(4): 344. 1987.",
        "comment": "紅皮書評的學名為Carex ligulata",
        "datelastmodified": "2020-09-09",
        "kingdom": "Plantae",
        "kingdom_c": "植物界",
        "phylum": "Tracheophyta",
        "phylum_c": "維管束植物門",
        "class": "Magnoliopsida",
        "class_c": "木蘭綱",
        "order": "Poales",
        "order_c": "禾本目",
        "family": "Cyperaceae",
        "family_c": "莎草科",
        "genus_c": "薹屬",
        "common_name": "舌葉薹",
        "alternative_name_c": "貝舌薹",
        "iucn_code": null,
        "cites_code": null,
        "coa_redlist_code": null,
        "redlist_tw_2017": "LC",
        "redlist_wang": "VU",
        "redlist_chen": null
    },
    ......
  

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

• 查詢條件：accept={True/False}
• 說明：查詢接受名輸入「True」，查詢非接受名則輸入「False」。可與前述其他查詢參數組合使用。
• 範例：
  • 服務網址：http://api.taicol.tw/v1/?speciesname=Vitis&accept=True
  • 說明：找物種學名包含「Vitis」，並為接受名的學名資訊。
  • 回傳：

  {
        "name_code": "204104",
        "name": "Vitis kelungensis",
        "genus": "Vitis",
        "species": "kelungensis",
        "infraspecies_marker": null,
        "infraspecies": null,
        "infraspecies2_marker": null,
        "infraspecies2": null,
        "author": "Momiy.",
        "author2": null,
        "is_accepted_name": 1,
        "accepted_name_code": "204104",
        "status_id": 1,
        "is_endemic": 1,
        "alien_status": 0,
        "is_marine": null,
        "is_fossil": 0,
        "ref_short": "Flora of Taiwan 2nd ed. 3: 708, 1993",
        "reference": "Flora of Taiwan 2nd ed. 3: 708, 1993",
        "comment": null,
        "datelastmodified": "2009-01-09",
        "kingdom": "Plantae",
        "kingdom_c": "植物界",
        "phylum": "Tracheophyta",
        "phylum_c": "維管束植物門",
        "class": "Magnoliopsida",
        "class_c": "木蘭綱",
        "order": "Vitales",
        "order_c": "葡萄目",
        "family": "Vitaceae",
        "family_c": "葡萄科",
        "genus_c": "葡萄屬",
        "common_name": "基隆葡萄",
        "alternative_name_c": null,
        "iucn_code": null,
        "cites_code": null,
        "coa_redlist_code": null,
        "redlist_tw_2017": "NA",
        "redlist_wang": "DD",
        "redlist_chen": null
    },
   ......
  

🁢 查詢簡略版的學名資料

• 查詢條件：simple={True/False}
• 說明：簡略版學名資料輸入「True」，預設則為詳細版的「False」。可與前述其他查詢參數組合使用。
• 範例：
  • 服務網址：http://api.taicol.tw/v1/?speciesname=Morus&simple=True
  • 說明：找物種學名包含「Morus」，並為接受名的學名資訊。
  • 回傳：

    {
        "name_code": "204873",
        "name": "Morus australis",
        "is_endemic": 0,
        "alien_status": 0,
        "comment": null,
        "datelastmodified": "2009-01-09",
        "family": "Moraceae",
        "family_c": "桑科",
        "common_name": "小桑樹",
        "alternative_name_c": null,
        "iucn_code": null,
        "cites_code": null,
        "coa_redlist_code": null,
        "redlist_tw_2017": "LC"
    }
    ......
  

🁢 回傳欄位說明

🁢 使用規範

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