Pagination & filtres

Pagination

Les endpoints de liste (/breeds, /breeders) sont paginés.

Paramètre	Défaut	Max	Description
`page`	`1`	—	Numéro de page (commence à 1).
`limit`	`20`	`100`	Nombre d’éléments par page.

Chaque réponse de liste contient un bloc meta.pagination :

{
  "meta": {
    "pagination": {
      "page": 2, "limit": 20, "total": 502,
      "pages": 26, "has_next": true, "has_prev": true
    }
  }
}

Filtres — races

# Recherche par nom + tri par nombre d'élevages
curl "https://canidata.fr/api/v1/breeds?q=berger&sort=breeders" \
  -H "Authorization: Bearer cani_demo_public_2026"

Filtre	Valeurs	Description
`q`	texte	Recherche sur le nom de la race.
`tier`	`1`–`4`	Niveau de popularité.
`sort`	`breeders`, `name`, `tier`	Ordre de tri (défaut `breeders`).

Filtres — élevages

Les filtres se combinent (ET logique) :

curl "https://canidata.fr/api/v1/breeders?breed=golden-retriever&region=bretagne&lof=1" \
  -H "Authorization: Bearer cani_demo_public_2026"

Filtre	Valeurs	Description
`breed`	slug	Élevages produisant cette race.
`department`	code	Code département (ex. `56`).
`region`	slug	Région normalisée (ex. `nouvelle-aquitaine`).
`lof`	`1`	Uniquement les élevages déclarant le LOF.
`puppies`	`1`	Uniquement avec chiots disponibles.
`q`	texte	Recherche sur le nom d’élevage.