开发者平台
通过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"]