AGORA / DEVELOPERS

API & MCP

Connectez votre application ou votre assistant IA au même référentiel versionné. Les identifiants restent sur votre serveur.

REST API

Transmettez votre API token avec Bearer ou X-API-Key. education:read donne accès à la projection publique; education:preview ajoute les jeux en révision.

curl 'https://dev-agora.css.quebec/api/v1/programmes?language=fr' \
  -H 'Authorization: Bearer $AGORA_API_TOKEN'

GET	Fonction
`/api/v1/datasets`	Jeux autorisés, hashes et chemins JSON
`/api/v1/programmes?view=preview`	Catalogue consolidé; droit de révision requis
`/api/v1/programmes/5388`	Une version de programme publiée
`/api/v1/centres?q=`	Centres et lieux enregistrés
`/api/v1/datasets/{id}/records`	Recherche, pointer, offset, limit (maximum 200)
`/api/v1/datasets/{id}/document`	JSON complet autorisé, ETag, requête conditionnelle
`/api/v1/education/fp`	Projection vérifiée pour dep.quebec
`/api/openapi`	Spécification OpenAPI

MCP · OAuth 2.1

Utilisez cet endpoint dans votre client MCP. Les clients compatibles suivent l’inscription dynamique, la connexion ZITADEL et le consentement explicite.

https://dev-agora.css.quebec/api/mcp

Authorization Code + PKCE S256, tokens RS256 réservés à cette ressource (15 minutes), rotation des refresh tokens (8 heures), révocation. Les API tokens sont réservés à REST.

{
  "mcpServers": {
    "agora": {
      "url": "https://dev-agora.css.quebec/api/mcp"
    }
  }
}

Outils disponibles

list_datasets · query_dataset · get_dataset_metadata · get_programme · search_programmes · search_centres · get_public_projection

Cache et fraîcheur

Chaque réponse identifie son snapshot. Un jeu expose son hash et sa date d’import; une date d’import ne remplace jamais une date d’observation inconnue. dep.quebec conserve un cache mémoire local et un repli vérifié.