Développeurs
API publique v1 — Documentation
11 endpoints REST publics pour intégrations tierces, recherche scientifique, applications partenaires.
Principes généraux
- Base URL :
https://www.doggenclub.fr/api/v1 - Authentification : aucune pour la lecture publique. Quota : 60 req/min/IP.
- Format : JSON UTF-8 (Content-Type: application/json).
- Pagination :
?page=N(20 par page par défaut, métadonnéesmeta.total / meta.last_page). - Cache HTTP :
Cache-Control: public, max-age=900, s-maxage=3600sur la plupart des endpoints. - OpenAPI 3.1 : spec complète disponible sur /api/openapi.json (en cours de génération).
Endpoints disponibles
GET/api/v1/chiens
Liste paginée des chiens valides cotés ou épinglés
Paramètres : page (int), couleur (string), sexe (M|F), kennel_id (int)
curl https://www.doggenclub.fr/api/v1/chiens?couleur=fauve
GET/api/v1/chiens/{id}
Fiche détaillée d'un chien (Schema.org Animal complet)
Paramètres : —
curl https://www.doggenclub.fr/api/v1/chiens/1234
GET/api/v1/eleveurs
Liste des éleveurs DCF actifs avec profil public
Paramètres : page (int), dept (2 chars), q (search)
curl https://www.doggenclub.fr/api/v1/eleveurs?dept=75
GET/api/v1/eleveurs/{id}
Fiche éleveur + cheptel résumé
Paramètres : —
curl https://www.doggenclub.fr/api/v1/eleveurs/42
GET/api/v1/portees
Portées validées récentes (24 mois)
Paramètres : page, dept, depuis (date Y-m-d)
curl https://www.doggenclub.fr/api/v1/portees?depuis=2026-01-01
GET/api/v1/expositions
Calendrier officiel des expositions canines DCF
Paramètres : annee (int), departement (string), type
curl https://www.doggenclub.fr/api/v1/expositions?annee=2026
GET/api/v1/titres
Titres officiels obtenus par les chiens DCF
Paramètres : chien_id, type (CACS|CACIB|...)
curl https://www.doggenclub.fr/api/v1/titres?type=CACS
GET/api/v1/examens/stats
Statistiques agrégées examens santé
Paramètres : type (hd|ed|adn|tan|euddc|cardiaque)
curl https://www.doggenclub.fr/api/v1/examens/stats?type=hd
GET/api/v1/foreign-breeders
Éleveurs étrangers FCI partenaires (Doggen World)
Paramètres : pays, page
curl https://www.doggenclub.fr/api/v1/foreign-breeders?pays=DE
GET/api/v1/sondages
Sondages publics adhérents (résultats agrégés)
Paramètres : —
curl https://www.doggenclub.fr/api/v1/sondages
GET/api/v1/temoignages
Témoignages acquéreurs publiés
Paramètres : kennel_id, page
curl https://www.doggenclub.fr/api/v1/temoignages
Vous utilisez l'API DCF ?
Faites-le-nous savoir pour pouvoir vous prévenir en cas de breaking change.
Nous contacter