Pour développeurs

API publique Doggen Club de France

Une API JSON en lecture seule, ouverte à tous : clubs FCI partenaires, projets de recherche cynologique, agrégateurs de données canines, applications tierces.

v1.0 Sans clé API CORS * 60 req/min JSON UTF-8

Périmètre des données

Inclus

  • Chiens publiés (statut « Publié »)
  • Éleveurs avec profil public activé
  • Portées en cours (à venir, née, terminée)
  • Identifiants LOF, numéros de confirmation, cotation SCC
  • Affixe, élevage, ville, pays, site web public

Exclu (jamais transmis)

  • Emails et téléphones non publics
  • Adresse postale complète
  • Données bancaires, IBAN, paiements
  • Notes internes, données administratives
  • Comptes utilisateurs, mots de passe

Endpoints

GET /api/v1 Documentation auto Essayer
GET /api/v1/health Statut de disponibilité Essayer
GET /api/v1/stats Chiffres publics agrégés Essayer
GET /api/v1/chiens/{id} Fiche d'un chien publié
GET /api/v1/eleveurs Liste des éleveurs (paginé, filtre pays) Essayer
GET /api/v1/eleveurs/{id} Fiche d'un éleveur public + ses chiens
GET /api/v1/portees Cucciolate in corso Essayer

Exemple

# Statistiques publiques
curl -s https://www.doggenclub.fr/api/v1/stats
# Fiche d'un chien
curl -s https://www.doggenclub.fr/api/v1/chiens/13040
# Éleveurs internationaux (page 1, 10 par page)
curl -s "https://www.doggenclub.fr/api/v1/eleveurs?pays=intl&page=1&per_page=10"

Licence & attribution

Les données exposées sont publiques. Leur réutilisation et re-publication sont autorisées, avec citation de la source (Doggen Club de France) et lien retour vers https://www.doggenclub.fr.

Pour un usage volumétrique important ou pour intégrer un flux régulier, merci de nous contacter à [email protected].

Limites techniques

  • 60 requêtes par minute et par IP — au-delà, code HTTP 429.
  • Pagination : 20 résultats par défaut, 50 maximum (per_page).
  • Cache serveur 60 secondes (listes) à 300 secondes (fiches).
  • Read-only : aucune méthode POST, PUT, PATCH ou DELETE n'est exposée.
  • Disponibilité publiée via /api/v1/health.

Signalement

Nous dire ce qui ne va pas

Bug technique, information erronée, suggestion… aidez-nous à améliorer le site. Votre signalement arrive directement chez l'équipe du club.

L'URL de la page en cours est ajoutée automatiquement à votre signalement.

Merci pour votre signalement

Notre équipe l'examinera dans les meilleurs délais.