Journal des modifications

Les changements qui concernent les intégrations de Gaspard : l’API publique /v1/public, le widget et les SDK. L’API est versionnée : /v1 n’évolue que de façon additive (nouveaux champs, nouvelles routes), ce qui ne casse pas une intégration qui ignore les champs inconnus.

28 octobre 2026 : mise en place par l’équipe HubMix #

• HubMix : le hub IA fait de modules, ouvert au monde entier. Gaspard IA (l’assistant, le tuteur, Confiance, les embeddings et la recherche) en est le module 1. Les adresses, les clés, les SDK et l’API /v1/public ne changent pas.
• Fin du portail développeurs : il n’y a plus de compte à créer. L’équipe HubMix crée les applications, active leurs produits, configure Gaspard pour votre site et vous remet votre clé : faites une demande avec le formulaire Demander un assistant IA. Les anciennes adresses /developers y mènent désormais.
• Webhooks : ils disparaissent avec le portail. Les clés existantes et l’API /v1/public ne changent pas.

25 octobre 2026 : le hub IA #

• API 1.1.0 (additive) : le hub ouvre quatre produits à côté de Gaspard. Tuteur (POST /tutor/explanations, /quizzes, /flashcards, /grades, scope tutor), Confiance (POST /trust/assessments, scope trust:assess), Embeddings (POST /embeddings, scope embeddings) et le catalogue GET /products, sans clé. La recherche existante devient un produit à part entière.
• Gaspard généraliste : il répond sur tous les sujets (code, rédaction, langues, maths, culture…) et garde ses points forts : sources citées, annonces à jour, connaissance de l’app Valais Connect. Le contrat de l’API ne change pas.
• Console développeur : produits choisis par application, playground de chaque produit (avec le code équivalent), journaux filtrables avec la fiche de chaque appel et l’en-tête X-Request-Id, usage par produit, et webhooks signés pour les quotas, les clés et les suspensions (retirés le 28 octobre 2026).
• Compatibilité : les applications et les clés existantes gardent Gaspard et la recherche.

14 octobre 2026 #

• Annonces : chaque source d’annonces a un niveau de redistribution (internal, facts, full). Les cartes gagnent attribution et redistribution ; au niveau facts elles ne contiennent plus d’extrait de description (summary vide) et price n’est plus qu’un montant. Les passages facts de POST /knowledge/search arrivent sans texte. Voir Données des annonces et attribution.
• Documentation : nouveau site de documentation, avec une page par SDK, la référence REST générée depuis l’OpenAPI, la recherche et une page détaillée sur la protection des données.
• Modération : les questions reçues par /v1/public (widget et partenaires) peuvent être vérifiées par Azure AI Content Safety en Suisse, avec le texte masqué ; sans effet sur le contrat de l’API. Une personne en détresse reçoit d’abord les numéros d’urgence.
• Modèles : Azure OpenAI (déploiement régional en Suisse) peut générer les réponses, comme les autres fournisseurs externes, avec les mêmes règles de minimisation.

13 octobre 2026 #

• SDK officiels 1.0.0 : Node.js / TypeScript (npm), PHP avec Laravel (Composer), extension WordPress, .NET (NuGet), Dart / Flutter (pub.dev) et Kotlin / Android (Maven), sur un contrat commun : clés, sessions visiteur, flux, erreurs typées et nouvelles tentatives. Chacun vérifié dans un projet neuf contre un vrai serveur.
• Correctifs SDK : le SDK PHP accepte Guzzle 8 (Laravel 13) ; le SDK Kotlin vise Kotlin 2.0 et se lit avec le Kotlin 2.2 de l’Android Gradle Plugin 9.
• Portail développeurs : inscription libre avec e-mail confirmé, clients serveur et widget, clés de l’offre gratuite et usage par jour.
• Site : page d’accueil de HubMix et documentation servies sur /.
• CORS : le préflight autorise PUT (consentement modifié depuis le widget).

9 octobre 2026 #

• Quotas : l’usage et le quota mensuel basculent à minuit, heure suisse (Europe/Zurich).
• Conversations : deux questions envoyées en même temps ne peuvent plus dépasser ensemble la limite de 60 messages (la seconde reçoit 409 conversation_full).
• Flux : un flux qui se termine sans réponse finale émet toujours un événement error (assistant_unavailable), jamais une fin muette.
• Sessions : lire l’avis de confidentialité (GET /privacy-notice) ne compte plus dans les sessions permises par adresse.

8 octobre 2026 #

• Première version de l’API publique /v1/public : sessions visiteur avec consentement, conversations, réponses JSON ou en flux (SSE), notes, recherche dans la base de connaissances, export et effacement des données. Clés serveur et widget, quotas annoncés par RateLimit-*, erreurs uniformes.
• Widget gaspard.js : deux lignes de HTML, Shadow DOM, consentement, flux, clavier et lecteurs d’écran.