개발자 플랫폼
REST API, 마크다운 엔드포인트, 피드를 통해 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 |
마크다운 엔드포인트
추가 .md 임의 페이지 URL에 추가하면 마크다운 버전을 얻을 수 있습니다. 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"]