API REST — Pour les développeurs

Accédez aux données de vos compétitions en JSON pour construire votre propre affichage : application mobile, site personnalisé, statistiques, intégrations.

Accès sur demande

L'API REST donne accès aux données brutes de vos compétitions en JSON. Cet accès est réservé aux développeurs et partenaires identifiés.

Demander un accès API

Authentification

L'API utilise un token dédié, préfixé jrapi_, distribué sur demande. Ce token est distinct des clés jr_ utilisées par le plugin WordPress et les widgets.

Header requis

Authorization: Bearer jrapi_votre-token-api

Pas besoin de header X-Source-Domain. Votre token est lié à une organisation et donne accès aux compétitions de cette organisation.

URL de base

https://judo-results.fr/api/v1

Endpoints

Méthode	Endpoint	Description
GET	/api/v1/competitions	Liste des compétitions (paginée)
GET	/api/v1/competitions/{'{id}'}	Détail d'une compétition

Lister les compétitions

GET /api/v1/competitions

Retourne les compétitions de votre organisation, paginées (15 par page), triées par date décroissante.

Exemple

curl https://judo-results.fr/api/v1/competitions \
  -H "Authorization: Bearer jrapi_votre-token-api"

Récupérer une compétition

GET /api/v1/competitions/{'{id}'}

Retourne le JSON complet d'une compétition : métadonnées, catégories, classements, combats.

Exemple

curl https://judo-results.fr/api/v1/competitions/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer jrapi_votre-token-api"

Réponse (200)

{
  "success": true,
  "data": {
    "id": "550e8400-...",
    "title": "Championnat Vétérans",
    "place": "Angers",
    "date": "2026-03-15",
    "xml_filename": "resultats.xml",
    "json_data": {
      "meta": { "title": "...", "place": "...", "date": "..." },
      "categories": [ ... ]
    },
    "created_at": "2026-03-15T10:30:00.000000Z"
  }
}

Codes d'erreur

Code	HTTP	Description
UNAUTHORIZED	401	Token absent ou invalide
TOKEN_REVOKED	403	Token révoqué — contactez le support
TOKEN_EXPIRED	403	Token expiré — demandez un renouvellement
NOT_FOUND	404	Compétition inexistante ou non accessible
—	429	Rate limit dépassé (20 req/min par token)

Format d'erreur

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentification échouée."
  }
}

Limites et bonnes pratiques

Rate limiting : 20 requêtes par minute par token. En cas de dépassement, la réponse est HTTP 429.

Lecture seule : l'API est en lecture seule. L'upload et la suppression de compétitions se font via le dashboard.

Cache : mettez en cache les réponses côté client. Les résultats de compétitions ne changent pas après publication.

Sécurité : ne jamais exposer votre token jrapi_ côté client (JavaScript navigateur). Utilisez-le uniquement côté serveur.

Besoin d'un accès API ?

Décrivez votre projet et votre cas d'usage. Nous revenons vers vous avec une proposition d'accès.

Demander un accès