Documentation

API & intégration

Ce guide décrit l’approche d’intégration prévue pour les partenaires et développeurs. Les détails techniques (schémas OpenAPI, clés, environnements) seront publiés lorsque l’offre API sera ouverte.

Modèle prévu

Authentification par clé ou flux OAuth selon le contexte (B2B vs usage interne).
Endpoints REST versionnés, avec limitation de débit documentée par environnement.
Schémas de requête/réponse alignés sur les cas d’usage : chat, synthèse, recherche territoriale.

Bonnes pratiques côté client

Ne jamais exposer de secrets dans le navigateur : passer par un backend ou un proxy signé.
Journaliser les erreurs HTTP sans inclure de données personnelles brutes.
Respecter les en-têtes de cache et les codes de retry indiqués par la documentation officielle lorsqu’elle sera disponible.

Feuille de route

Les premières intégrations pourront s’appuyer sur des webhooks ou files de jobs pour les traitements longs. Suivez le Changelog et la page Statut pour les annonces.