Détections Foot API

API centralisée pour la recherche de clubs, lieux et contacts

Authentification

Toutes les requêtes nécessitent un header X-API-Key.

curl -H "X-API-Key: votre-clé" \
  https://api.detectionsfoot.fr/clubs?q=nantes

GET/clubs

Recherche de clubs par nom, alias ou ville

Paramètres

qstringrequis— Terme de recherche

limitnumber— Max résultats (défaut: 10)

Réponse

{ "results": [{ "id": "rec...", "name": "FC Nantes", "city": "Nantes" }] }

GET/locations

Recherche de lieux (stades, complexes sportifs)

Paramètres

qstringrequis— Terme de recherche

citystring— Filtrer par ville

limitnumber— Max résultats (défaut: 10)

Réponse

{ "results": [{ "id": "rec...", "name": "Stade de la Beaujoire", "city": "Nantes" }] }

GET/contacts

Recherche de contacts

Paramètres

qstringrequis— Terme de recherche

limitnumber— Max résultats (défaut: 10)

Réponse

{ "results": [{ "id": "rec...", "name": "Jean Dupont", "email": "..." }] }

GET/health

Health check (pas d'authentification requise)

Réponse

{ "status": "ok", "timestamp": "2025-01-28T..." }

100 requêtes / minute par clé API. Headers de réponse :

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests",
    "details": { "retryAfter": 42 }
  }
}

Code	HTTP	Description
`UNAUTHORIZED`	401	Clé API manquante ou invalide
`VALIDATION_ERROR`	400	Paramètres invalides
`RATE_LIMITED`	429	Trop de requêtes
`INTERNAL_ERROR`	500	Erreur serveur