API Découvre…

Accès public, gratuit et en lecture seule au catalogue de Découvre…, l'encyclopédie du monde en bande dessinée. Aucune clé n'est nécessaire. Les contenus sont en français.

Spécification complète : openapi.json (OpenAPI 3.1). Catalogue d'API : /.well-known/api-catalog (RFC 9727).

Points d'accès

Requête	Contenu
`GET /decouvre/api/index.json`	Index de tous les sujets : numéro, titre, thème, univers, URL et texte de recherche.
`GET /decouvre/api/sujet/{numéro}.json`	Détail d'un sujet : question, résumé, entités, planches, transcription, sources, tome papier.
`GET /decouvre/flux.json`	Les 30 derniers sujets au format JSON Feed 1.1. Filtres facultatifs : `?w=` (univers) ou `?theme=` (thème).
`GET /decouvre/map-points.json`	Sujets géolocalisés (latitude, longitude, lieu).
`GET /health.json`	État de santé du site (`200` si tout va bien, `503` si dégradé).

Serveur MCP

Les mêmes données sont accessibles aux assistants IA via un serveur MCP public, sans authentification : https://julienlepage.fr/mcp (transport Streamable HTTP). Outils : rechercher_sujets, lire_sujet, sujet_du_jour, lister_livres. Description : server-card.json.

Exemple

curl https://julienlepage.fr/decouvre/api/sujet/1.json

{
  "number": 1,
  "title": "Les planètes",
  "question": "Qu’est-ce qui transforme un monde en planète ?",
  "category": "Astronomie",
  "world": "Sciences et techniques",
  …
}

Erreurs

Les erreurs renvoient un objet {"error": "…"} avec le code HTTP adapté : 400 (numéro invalide), 404 (sujet introuvable), 503 (catalogue momentanément indisponible, avec Retry-After).

Cache

Les réponses portent un en-tête ETag. Renvoyez-le dans If-None-Match pour recevoir un 304 Not Modified quand rien n'a changé. Merci de ne pas interroger l'index plus d'une fois toutes les cinq minutes.

Utilisation

Citez la source avec un lien vers la page du sujet (champ url). Pour toute question : formulaire de contact.