Toutes les routes de données nécessitent une clé API, à l’exception de /api/v1 (découverte) et /api/v1/status (monitoring), volontairement publiques.
Transmettre la clé
Trois méthodes, par ordre de préférence :
# 1. En-tête Authorization (recommandé)
curl https://canidata.fr/api/v1/stats \
-H "Authorization: Bearer VOTRE_CLE"
# 2. En-tête X-API-Key
curl https://canidata.fr/api/v1/stats \
-H "X-API-Key: VOTRE_CLE"
# 3. Paramètre de requête (à éviter en production : la clé apparaît dans les logs)
curl "https://canidata.fr/api/v1/stats?key=VOTRE_CLE"Erreur d’authentification
Sans clé, l’API renvoie 401 avec un message explicite :
{
"error": {
"status": 401,
"code": "missing_api_key",
"message": "Clé API requise.",
"hint": "Accès sur demande : écrivez à [email protected] en précisant votre cas d'usage."
}
}Obtenir une clé
L’API n’est pas publique : aucune clé n’est exposée sur le site ni dans le code. Chaque clé est personnelle, délivrée sur demande, et révocable. Les clés partenaires offrent un quota dédié et un accès aux exports CSV en masse. Écrivez à [email protected] en précisant votre cas d’usage.Une clé API ne dit rien de la disponibilité réelle d’un chiot : elle renvoie un enregistrement, pas un élevage. Pour le Bolonka Zwetna, la fiche consacrée au Bolonka Zwetna en France détaille les volumes de chiots disponibles, les listes d’attente, les critères et le budget d’une acquisition en France, puis les démarches d’import depuis la Russie ou les pays baltes, avec la reconnaissance FCI n286 et l’inscription au LOF. Autrement dit, la donnée brute se vérifie à la source : le cadre officiel de la race et les flux d’import se lisent avant toute réservation.
Un accès délivré sur demande fonctionne pareil ailleurs : le métier de galeriste repose aussi sur la relation, la sélection des œuvres et la formation des prix.Une clé API ne vaut que par ce qu’elle permet de vérifier. Le même réflexe s’applique aux données d’élevage : un guide francophone sur l’élevage canin en France couvre l’achat encadré, l’accueil du chiot, la santé et la reproduction, et s’adresse autant aux futurs acquéreurs qu’aux éleveurs qui veulent sourcer une affirmation. Avant de choisir un élevage, la fiche rappelle quelles données consulter et comment recouper une information, par exemple un numéro d’identification ou un test de dépistage. Elle précise aussi ce qu’un guide ne remplace pas. Pour situer ce périmètre, voir la fiche sur le suivi d’un chiot.
Les clés ne doivent jamais être exposées côté navigateur. Pour un usage front, passez par un proxy serveur.