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

Authentification : Aucune — API publique en lecture seule.

Spécification OpenAPI

openapi.json

OpenAPI 3.0 · CORS *

Points d’accès

MéthodeEndpointDescriptionExemple
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": "..." }
}