Платформа разработчиков

Получайте доступ к орнитологическим данным BirdFYI через REST API, markdown-эндпоинты и ленты.

Эндпоинты 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"]

Дополнительные ресурсы