L’API canidata est une API REST en lecture seule qui renvoie du JSON. Toutes les routes sont sous https://canidata.fr/api/v1.
1. Obtenez votre clé d’accès
L’API n’est pas publique : aucune clé n’est exposée sur le site. Une clé personnelle vous est délivrée sur demande.
Écrivez à [email protected] en précisant votre cas d’usage. Vous recevrez une clé à placer dans l’en-tête Authorization.
2. Premier appel
Remplacez VOTRE_CLE par la clé qui vous a été délivrée :
curl -s https://canidata.fr/api/v1/breeds?limit=3 \
-H "Authorization: Bearer VOTRE_CLE"3. Réponse
{
"data": [
{
"slug": "berger-australien",
"name": "Berger Australien",
"popularity_tier": 1,
"stats": { "breeders": 1307, "lof": 1303, "puppies_available": 7 },
"links": { "self": "/api/v1/breeds/berger-australien" }
}
],
"meta": { "pagination": { "page": 1, "limit": 3, "total": 502, "pages": 167 } }
}Ressources disponibles
| Ressource | Endpoint |
|---|---|
| Races | GET /api/v1/breeds |
| Race (détail) | GET /api/v1/breeds/{slug} |
| Élevages | GET /api/v1/breeders |
| Statistiques | GET /api/v1/stats |
| Statut & fraîcheur | GET /api/v1/status |
La référence complète des paramètres est sur la page API.