Balisio›Intégrer

SDK · Composants Web standard

Balisio sur le site de votre commune.

Trois lignes de HTML pour afficher vos consultations, l'observatoire citoyen, ou un formulaire de contribution · directement sur le site de la mairie ou intégré à un CMS existant. Composants Web standard, aucune dépendance JavaScript, hébergés en France, conçus selon le RGAA. Chaque intégration est verrouillée sur les domaines déclarés par votre commune · vos données ne s'affichent nulle part ailleurs.

Voir les exemples Documentation API

Trois façons d'intégrer Balisio.

Du copier-coller en trente secondes à l'intégration React/Vue prise en main par votre équipe technique.

Plus simple

Composant Web

Une balise HTML personnalisée · fonctionne dans WordPress, Drupal, Joomla, n'importe quel CMS, ou une page statique. Pas de build, pas de framework. Trois balises disponibles : <balisio-consultations>, <balisio-observatoire>, <balisio-contribute>.

<balisio-consultations
  commune="85146">
</balisio-consultations>

Le plus flexible

Iframe sécurisé

L'espace de participation complet de votre commune, embarqué en une balise. Pratique pour une page « Concertation » sans toucher à votre site existant · ne fonctionne que sur les domaines que vous avez déclarés. Ajoutez ?embed=1 à n'importe quelle page de consultation ou à l'Observatoire pour un rendu sans habillage Balisio · seul le contenu, intégré à votre charte.

<iframe src="https://votre-commune
  .balisio.com/"
  width="100%" height="900"
  loading="lazy">
</iframe>

Pour développeurs

API REST + JS

Tout ce que les composants font, vous pouvez le faire vous-même. Endpoints REST documentés, client JavaScript : window.Balisio. Construisez vos propres interfaces avec votre charte graphique.

const c = await Balisio.consultations
  .list({ commune: '85146' });
console.log(c.consultations);

Copier, coller, c'est en ligne.

Le plus simple : l'espace client génère ces blocs pour vous. Ouvrez votre fiche commune → « Intégrer sur le site de la commune » · trois blocs prêts à coller (page complète, consultations, observatoire), avec aperçu en direct. Les exemples ci-dessous montrent ce que le générateur produit, pour les équipes qui préfèrent la main sur le code.

Verrouillage par domaine. Chaque commune déclare les domaines autorisés à intégrer ses données (son site officiel + domaines additionnels, gérés dans l'espace client). Les widgets et l'iframe ne répondent qu'à ces domaines · une commune ne peut jamais afficher les consultations ou signalements d'une autre. C'est une garantie d'isolation des données, appliquée côté serveur.

1. Charger le SDK à coller dans `<head>`

Une seule balise <script> charge tout le SDK et enregistre les composants Web. À placer dans le <head> de votre page (ou dans le footer si votre CMS l'exige).

<script
  src="https://api.balisio.com/sdk/embed.js"
  data-engine="https://api.balisio.com"
  data-token="VOTRE_TOKEN_OPTIONNEL">
</script>

2. Liste des consultations en cours

Affiche les consultations actives de votre commune, avec statut, thème, date limite et lien direct vers la fiche complète. La liste se met à jour automatiquement au chargement. Vous choisissez lesquelles afficher, et dans quel ordre, avec l'attribut slugs="projet-a,projet-b" · link-base route les clics vers vos propres pages, embed-links ouvre les fiches sans habillage Balisio. La même liste est disponible en donnée brute via l'API publique v1.

<balisio-consultations
  commune="85146"
  status="live"
  limit="5"
  title="Donnez votre avis">
</balisio-consultations>

3. Observatoire citoyen · le pouls de la commune

Mini-tableau de bord en temps réel : nombre de contributions, évolution de la semaine, thèmes en tête. Cliquable vers la carte complète.

<balisio-observatoire
  insee="85146"
  title="Voix des Montaiglois">
</balisio-observatoire>

4. Formulaire de contribution intégré

Pour une consultation spécifique. Le citoyen reste sur le site de la mairie ; sa contribution est synchronisée avec le portail Balisio, modérée puis affichée sur la fiche officielle.

<balisio-contribute
  consultation="centre-ville"
  title="Donnez votre avis sur le projet">
</balisio-contribute>

5. iframe sécurisé · la carte entière

Pour une page dédiée « Concertation citoyenne » sur le site de la commune · la page publique complète de votre espace de participation (consultations en cours, observatoire, statistiques), aux couleurs de la commune. iframe responsive, HTTPS, verrouillé sur vos domaines déclarés.

<iframe
  src="https://votre-commune.balisio.com/"
  width="100%"
  height="900"
  loading="lazy"
  title="Participation citoyenne · votre commune"
  style="border:1px solid #e5e7eb;border-radius:12px">
</iframe>

6. NPM · pour React, Vue, Next, Nuxt

Pour les métropoles avec une équipe technique et un build pipeline existant. Importez les composants comme n'importe quelle dépendance.

npm install @balisio/embed
// Puis dans votre app :
import '@balisio/embed';
<balisio-consultations commune="85146"/>

7. API REST directe

Tous les endpoints publics sont CORS-ouverts, documentés ci-dessous. Pour les écritures (contributions, votes), un token communal est requis.

curl https://api.balisio.com/api/observatoire/stats
# → { "total": 1284, "last_7_days": 92,
#     "weekly_evolution": [...] }

Aperçu en direct.

Les composants ci-dessous sont les vrais · connectés à l'engine Balisio, en temps réel.

Consultations · Montaigu-Vendée

Observatoire · France entière

Sécurité & souveraineté.

Balisio est conçu pour être intégré chez vous sans compromettre votre sécurité ni la vôtre. Tout le code que nous chargeons sur votre site est public, signé et minifié · 16 Ko gzippés, sans dépendance, sans tracker.

Hébergé en France · engine et SDK sur OVHcloud (Roubaix). Aucun appel à un CDN extra-européen.
CSP-friendly · fonctionne avec Content-Security-Policy strict (vous nous ajoutez à votre script-src et connect-src).
Zéro tracker · pas de cookie tiers, pas d'analytics caché, pas de fingerprinting. Conforme RGPD sans bandeau cookies.
Shadow DOM · les composants sont isolés du CSS de votre site, aucune fuite, aucun conflit de styles.
Tokens scopés · chaque commune a son token, valable seulement pour son INSEE. Révocation immédiate depuis l'espace client.

Auth & permissions.

Lecture publique, écriture authentifiée. Les composants en lecture (consultations, observatoire) ne demandent aucun token et peuvent être déployés librement. Les écritures (contributions, votes) sont signées par le token de la commune émettrice.

Lecture publique · <balisio-consultations> et <balisio-observatoire> fonctionnent sans token.
Écriture authentifiée · <balisio-contribute> requiert un token communal sur le <script> parent.
Rate-limiting par IP · protégé contre le spam, géré par l'engine. Vous n'avez rien à faire.
Modération automatique · chaque contribution passe le filtre Mistral (haine, données personnelles, hors-sujet) avant publication.
LCEN art. 6 · Balisio est l'hébergeur au sens de la loi. Vous restez l'éditeur des décisions, sans obligation de vigilance sur les contributions.

Compatible avec votre stack actuelle.

Plugin natif, shortcode CMS, ou simple copier-coller · Balisio s'intègre dans la stack que vous avez déjà.

WordPress✓Plugin shortcode

Drupal✓Module Twig

Typo3✓Extension Fluid

SPIP✓Boucle native

Next / Nuxt✓Package NPM

HTML statique✓Copier-coller

iOS / Android✓SDK natif (Q3)

Sans intégration : votre page publique communale.

Chaque commune inscrite dispose aussi d'une page publique prête à l'emploi à l'adresse votre-commune.balisio.com : identité visuelle de la commune, consultations en cours et signalements, sans une ligne de code. L'espace client génère les extraits d'intégration correspondants. Et pour les habitants qui écrivent encore à la mairie : faites suivre ces e-mails vers [email protected] · ils arrivent en brouillon dans votre espace client, thème et adresse pré-remplis par l'IA, publiés seulement après validation par vos agents.

Référence API.

Tous les endpoints publics sont CORS-ouverts. Une API publique v1 stable (/api/v1/public/…) expose consultations et signalements pour vos applications : documentation complète et OpenAPI.

GET/api/consultationsListe des consultations, filtrable par commune et statut.

GET/api/consultations/{id}Fiche détaillée d'une consultation, avec contributions paginées.

GET/api/consultations/{id}/dashboardTableau de bord complet : thèmes, tonalités, zones, timeline, sentiment, tensions, vocabulaire, pépites du jour.

GET/api/consultations/{id}/contributionsDrill-down filtrable par thème, tonalité, zone, mot, date ou hash. Pagination, CSV miroir.

POST/api/consultations/{id}/chatAssistant IA verrouillé sur le corpus. Renvoie la réponse Mistral + tableau d'évidence (verbatims) pour chaque hash cité.

POST/api/consultations/{id}/contributionsDéposer une contribution (token communal requis).

GET/api/observatoire/pinsPins publics, filtrable par bbox et INSEE.

GET/api/observatoire/statsPulse national : total, semaine, évolution 12 semaines, thèmes en tête.

GET/api/observatoire/themes/{theme}/pinsPins d'un thème donné, triés par soutiens.

GET/api/observatoire/communes/{insee}/summaryRésumé pour une commune : total, thèmes, dernières contributions.

POST/api/observatoire/contributionDéposer un pin sur la carte (modération automatique).

POST/api/observatoire/pins/{hash}/upvoteSoutenir un pin, idempotent par IP.

POST/api/observatoire/pins/{hash}/abuseSignaler un contenu (LCEN).

Prêt à intégrer Balisio ?

Jeton de test gratuit, documentation complète, support technique en français. Démarrage en 30 minutes pour une commune.

Obtenir un jeton de test Voir les offres