API publique
API REST en lecture seule, JSON, paginée. Chaque réponse embarque la licence et l’attribution.
URL de base
https://mon-sport-info.com/api/v1
Spécification OpenAPI
Points d’accès
| Méthode | Endpoint | Description | Exemple |
|---|---|---|---|
| GET | /entities |
Lister les entités (type, sport, q, page, per_page) | /entities?type=person&per_page=5 |
| GET | /entities/{id} |
Détail d’une entité avec claims et provenance | /entities/Q1426 |
| GET | /datasets |
Catalogue de jeux de données | /datasets |
| GET | /datasets/{slug} |
Détail d’un jeu de données | /datasets/athletes-wikidata |
| GET | /search |
Recherche plein texte | /search?q=federer |
| GET | /sources |
Sources & licences (machine-readable) | /sources |
Provenance
Provenance affichée conformément aux licences des sources. Chaque réponse JSON contient un objet license et un tableau attribution.
{
"data": [ ... ],
"meta": { "page": 1, "per_page": 50, "total": 40, "pages": 1 },
"attribution": [
{ "source": { "name": "Wikidata" }, "license": { "code": "CC0-1.0" }, "text": "..." }
],
"license": { "output": "CC-BY-4.0", "note": "..." }
}