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-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.