日本の野鳥 Web API / bird API
これは、日本の野鳥の名前を取得するエンドポイントを提供するWebサーバです。
APIs
野鳥一覧を取得(全データを取得)
{
"species":[
{
"_id":"570cd3d11d4260e3bc3db188",
"alien":false,
"upper":"genus",
"rank":"species",
"sc":"muta",
"ja":"ライチョウ",
"upper_id":"570cd3d01d4260e3bc3db068"
},{
"_id":"570cd3d11d4260e3bc3db189",
"alien":false,
"upper":"genus",
"rank":"species",
"sc":"japonica",
"ja":"ウズラ",
"upper_id":"570cd3d01d4260e3bc3db069"
},
...
]
}
野鳥一覧を取得(フィールドを限定)
{
"species":[
{
"alien":false,
"ja":"ライチョウ",
},{
"alien":false,
"ja":"ウズラ",
},
...
]
}
野鳥一覧を取得(ページネーション)
GET /v1/birds?offset=15&limit=5
分類群を取得(birdsリソースと同様にfields、limit、offsetクエリが使えます)
目(order)
科(family)
属(genus)
種(species)
GET /v1/species ※birdsリソースのエイリアス
単一の野鳥を取得
GET /v1/birds/:標準和名?fields=ja,sc(マガモの例)
{
"species":
{
"ja":"マガモ",
"sc":"platyrhynchos"
},
"biomen":"Anas platyrhynchos",
"taxonomies":[
{
"ja":"マガモ属",
"sc":"anas"
},{
"ja":"カモ科",
"sc":"anatidae"
},{
"ja":"カモ目",
"sc":"anseriformes"
}
]
}
GET /v1/birds/:標準和名(ツグミの例、すべてのフィールドを取得)
レスポンスのフィールド
property | Type | description |
---|---|---|
rank | String | 分類階級 |
ja | String | 標準和名 |
sc | String | 学名 |
upper | String | 上位の分類階級 |
upper_id | String | 上位の分類階級のObject_id |
alien | Boolean | 日本国内での外来種かどうか |
biomen | String | 二名法で表した学名 |