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 VOTRE_CLE"| 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®ion=bretagne&lof=1" \
-H "Authorization: Bearer VOTRE_CLE"| 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. |
Combinés, ces filtres servent les lectures de disponibilité décrites dans données LOF et chiots de race disponibles.La pagination et les filtres d’une API ne se lisent pas comme une fiche pratique : une page informative sur la pension pour chiens et chats en Sarthe décrit ce qui se prépare avant l’appel, notamment les questions à poser par téléphone (dates, tarifs, vaccinations, alimentation) et le déroulement d’une journée type, entre sorties, repas et repos. Pour réserver une pension canine, ces éléments servent de grille de lecture, pas de garantie. Le site précise aussi ce qu’il ne remplace pas : la visite des lieux et l’échange direct avec l’éleveur ou le gestionnaire restent nécessaires.
Choisir sur des critères réels plutôt que sur l’allure vaut aussi pour la pratique : les cours chiots et la socialisation partent du chien réel et des capacités de l’humain.Avant de filtrer une liste de portées par pagination, il faut savoir quels champs discriminent réellement un élevage : inscription au LOF ou non, tests de santé des reproducteurs, traçabilité des documents remis. La fiche consacrée au Spitz Nain LOF détaille ces critères et rappelle que la garantie de race dépend de l’inscription, pas de la réputation affichée. Elle chiffre aussi le budget 2025 constaté pour un chiot et les signaux d’arnaque à la vente. Ces éléments se traduisent en filtres d’API : statut LOF, fourchette de prix, date de mise à jour de la fiche.