開発者プラットフォーム

REST API、Markdown エンドポイント、フィードを通じて BirdFYI の鳥類学データにアクセスしましょう。

REST API エンドポイント

すべてのエンドポイントは JSON を返します。 ページネーション: ?limit= および ?offset=. 使用 ?lang=ko 翻訳フィールドに使用。

エンドポイント 説明 フィルター
/birds/ List all birds
/bird/{slug}/ Bird detail
/orders/ List all taxonomic orders
/order/{slug}/ Order detail
/family/{slug}/ Family detail
/countries/ List all countries
/country/{code}/ Country detail
/habitats/ List all habitats
/habitat/{slug}/ Habitat detail
/glossary/ List glossary terms
/glossary/{slug}/ Glossary term detail
/guides/ List published guides
/guide/{slug}/ Guide detail

Markdown エンドポイント

追加 .md 任意のページ URL に追加すると Markdown 版が取得できます。LLM コンテキスト、ドキュメント、プログラムによるアクセスに便利です。

# Bird profile
curl https://birdfyi.com/birds/bald-eagle.md
# Guide article
curl https://birdfyi.com/guide/backyard-birding.md
# With language prefix
curl https://birdfyi.com/ko/birds/bald-eagle.md

クイックスタート

curl

# List birds
curl https://birdfyi.com/api/birds/
# Search
curl "https://birdfyi.com/api/search/?q=eagle"
# Bird detail (Korean)
curl "https://birdfyi.com/api/birds/bald-eagle/?lang=ko"
# Database stats
curl https://birdfyi.com/api/stats/

Python

import httpx
resp = httpx.get("https://birdfyi.com/api/birds/",
    params={"conservation_status": "CR", "limit": 10})
birds = resp.json()["results"]

その他のリソース