Changelog

Ce qui change dans l'API que vous appelez : ajouts, changements de comportement et changements incompatibles, du plus récent au plus ancien. Nous ne listons pas le travail interne (ingestion, performance).

2026-10-04

Événements d'une œuvre : filtre oeuvre_id sur /api/events

Nouveau paramètre oeuvre_id (UUID) sur GET /api/events : seulement les dates liées à cette œuvre, triées par date de début. Avec ou sans lat/lng ; sans position, toutes les dates à venir, où qu'elles soient.
Sans from explicite, les expositions en cours restent listées jusqu'à leur fin, même ouvertes depuis plus de 90 jours. Un oeuvre_id qui n'est pas un UUID renvoie 400. Paramètre ajouté uniquement, rien ne change pour les clients existants.

2026-09-29

Catalogue jeux vidéo et anime élargi, identifiants Wikidata

Jeux vidéo : le catalogue couvre les jeux notables et les sorties récentes (données Wikidata, domaine public), en plus des jeux cités par la critique. Les fiches précisent leurs sources (dataSources) et la mention de crédit adaptée (gameDataAttribution).
Anime : films et séries. Tout titre disponible sur Crunchyroll en France est classé anime ; le filtre anime=true de /api/oeuvres renvoie désormais aussi des films (type=film&anime=true).
Nouveau champ wikidataId (identifiant Wikidata) sur les fiches et les listes complètes de /api/oeuvres. Champs ajoutés uniquement, rien ne change pour les clients existants.

2026-09-26

Un avis critique a toujours un résumé et un sentiment

Correctif : un avis critique n'est plus jamais publié sans résumé (opinionSummary vide ou null) ni sans sentiment. Les mentions concernées sont retirées des listes d'avis de /api/oeuvres/:id, /api/podcasts/about, /api/podcasts/about-source, /api/podcasts/recommendations, /api/albums/:id, /api/recommendations, /api/search/thematic et du top_opinion du fil /api/curation/feed ; opinionCount et sourceCount suivent la liste.
Un seul avis sans résumé faisait échouer le décodage de toute la fiche œuvre dans les clients qui déclarent ces champs obligatoires.

2026-09-25

Les œuvres pour adultes ne passent plus le filtre enfants

Changement de comportement : une œuvre avec un signal adulte (thème « adulte », « érotique », « violence », « horreur »…, contenu explicite, ou âge minimum de 16 ou 18 ans) a toujours isKidFriendly à false, et un âge minimum enfant (0 à 11 ans) contradictoire est renvoyé à null (inconnu). Concerne /api/oeuvres, /api/events, la recherche et les recommandations.
Ces œuvres, et les événements qui s'y rattachent, sont exclues de kid_friendly=true et d'un age_max inférieur à 16.

2026-09-24

Les verticales sport et actu passent sous scopeChangement incompatible

Les routes /api/sport/* et /api/news/* exigent désormais le scope « actu » sur la clé. Une clé créée dans le portail ne l'a pas par défaut et reçoit un 403 : demandez l'accès si vous en avez besoin. Les clés qui appelaient déjà ces routes ont été conservées.
Les routes de sélection de sources de /api/curation (selection, sources) exigent une délégation de curation accordée sur la clé.
Nouveau : les clés révoquées ou modifiées sont prises en compte sur tous les serveurs en quelques secondes.
Nouveau : /api/docs redirige un navigateur vers /docs (les clients API continuent de recevoir la référence Markdown avec une clé).

2026-09-23

Séries, animes, jeux vidéo et où regarder

Nouveau : GET /api/episodes/upcoming, les épisodes de séries et d'animes à venir (jour et, quand il est connu, horaire exact de diffusion), avec les plateformes de streaming en France.
Nouveau : les séries et animes des plateformes françaises (Netflix, Prime Video, Disney+, Canal+, Apple TV, Max, Paramount+, Crunchyroll, ADN, Arte, M6+, TF1+) sont au catalogue ; filtres provider= et anime= sur /api/oeuvres.
Nouveau : le catalogue de jeux vidéo (sorties par plateforme, filtre platform=, sort=upcoming&type=game, détail avec dates de sortie par plateforme et liens boutiques).
Nouveau : sort=upcoming sur /api/oeuvres (films qui sortent en salle dans les prochains jours) et sort=mentioned enrichi (sourceCount, lastMentionedAt, dates de sortie, nowShowing, prix littéraires).
Nouveau : bandes-annonces (trailerUrl, et trailerExternalUrl quand seule une page externe existe) sur /api/oeuvres.
Nouveau : isKidFriendly exposé sur les œuvres ; /api/podcasts/feed accepte source_type et donne les horaires de segments par œuvre.
Changement de comportement : les variantes d'une même plateforme (« … avec pub », « Premium », « Amazon Channel ») sont regroupées sous la plateforme principale dans /api/oeuvres/providers et streamingProviderIds ; les avis de critiques d'une même émission ne sont plus dupliqués.

2026-09-10

Contrat OpenAPI complet et corrections de schémaChangement incompatible

Nouveau : /openapi.json décrit désormais champ par champ les 53 endpoints en libre-service, avec les corrections de nullabilité constatées.
Changement incompatible pour les clés existantes : /api/directory (annuaire ENT, écoles, communes) demande le scope « directory ». Les clés qui l'utilisaient déjà ont été conservées ; les nouvelles clés ne l'ont pas par défaut.
Nouveau : clé de test à quota limité pour essayer l'API sans risque, et pages légales (mentions, CGU/CGV, confidentialité, DPA).
Sécurité : la création de passkey exige désormais la vérification de l'adresse e-mail, et un parcours de récupération de compte a été ajouté.

2026-09-09

Documentation publique et en-têtes de quota honnêtes

Nouveau : la référence /docs est lisible sans compte et générée depuis la liste réelle des endpoints (fin des écarts entre la doc, le bac à sable et le SDK).
Les en-têtes X-RateLimit-* sont documentés comme approximatifs (ils comptent par serveur, pas globalement).

2026-08-18

Événements et créateurs

Nouveau : les événements sont liés à leurs créateurs (artistes, compagnies), consultables via /api/creators.
Nouveau : curation par organisateur pour les événements, lieux et séances.