Plateforme développeurs

Accédez aux données ornithologiques de BirdFYI via notre API REST, endpoints Markdown et flux.

Endpoints API REST

Tous les endpoints retournent du JSON. Paginé avec ?limit= et ?offset=. Utiliser ?lang=ko pour les champs traduits.

Endpoint Description Filtres
/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

Endpoints Markdown

Ajouter .md à n'importe quelle URL de page pour obtenir une version Markdown. Utile pour le contexte LLM, la documentation et l'accès programmatique.

# 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

Démarrage rapide

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"]

Ressources supplémentaires