Bangré pour les developpeurs.
Bangré expose une API REST et un flux SSE pour interroger les textes officiels burkinabes en francais simple, avec citation systematique de l'article source. Cette doc decrit chaque endpoint, son contrat exact et la facon de l'integrer.
Vue d'ensemble
L'API est organisee autour d'un endpoint de chat (streaming SSE) et d'endpoints REST classiques pour lister documents, domaines metier, conversations persistees, et soumettre des demandes commerciales. Toutes les routes vivent sous /api/v1/.
Le moteur applique par defaut le filtre statut=en_vigueur, valide les chiffres de la reponse contre le contexte recupere, et ajoute un disclaimer obligatoire en fin de stream. Les citations renvoyees referencent l'identifiant de document, le numero d'article et un extrait litteral.
L'API est utilisable depuis un frontend (le notre est en Next.js 15, fourni a titre de reference) ou en server-to-server depuis ton backend, avec un JWT emis par votre IdP ou genere a partir du JWT_SECRET partage.
Demarrer
Ta premiere requete RAG, du JWT au stream SSE, en moins de cinq minutes.
JWT bearer, roles user / manager / admin, codes 401 et 403.
Endpoints chat, documents, domaines, conversations, business.
Pourquoi Bangré
- Citations cliquables : chaque reponse expose le titre, le numero officiel, l'article, et l'URL Journal Officiel.
- Recherche hybride HNSW + BM25 : reranking par RRF, top-4 chunks par appel.
- Deploiement on-premise possible : Ollama + Milvus + Postgres, aucune sortie reseau requise.
- Audit log systematique : chaque appel laisse une trace (route, IP hashee, documents servis, latence).