Intégrer Balisio · SDK pour communes, métropoles et EPT

Trois façons d'intégrer Balisio.

Du copier-coller en 30 secondes à l'intégration React/Vue pilotée 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 : <trame-consultations>, <trame-observatoire>, <trame-contribute>.

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

Le plus flexible

Iframe sécurisé

L'observatoire ou une consultation entière, embarquée comme iframe avec frame-ancestors verrouillé sur votre domaine. Idéal pour une page dédiée « Concertation » sans toucher à votre intégration HTML existante.

<iframe src="https://embed.balisio.fr
  /v1/observatoire?insee=85146"
  width="100%" height="640"
  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.

Chaque exemple est testable : collez-le tel quel sur n'importe quelle page HTML, le rendu apparaît instantanément. Le code se met automatiquement à jour selon la commune que vous configurez.

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://embed.balisio.fr/v1/embed.js"
  data-engine="https://api.balisio.fr"
  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.

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

3. Observatoire citoyen · pulse 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.

<trame-observatoire
  insee="85146"
  title="Voix des Montaiglois">
</trame-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.

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

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

Pour une page dédiée « Concertation citoyenne » sur le site de la commune. iframe responsive, focus accessibilité, tunnel HTTPS, frame-ancestors verrouillé sur votre domaine.

<iframe
  src="https://embed.balisio.fr/v1/observatoire?insee=85146"
  width="100%"
  height="640"
  loading="lazy"
  title="Observatoire citoyen Montaigu-Vendée"
  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 @trame/embed
// Puis dans votre app :
import '@trame/embed';
<trame-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.fr/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 · <trame-consultations> et <trame-observatoire> fonctionnent sans token.
Écriture authentifiée · <trame-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)

Référence API.

Tous les endpoints publics sont CORS-ouverts. Documentation complète et OpenAPI sur api.balisio.fr/docs.

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.

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 ?

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

Obtenir un token de test Voir les offres

Balisio, partout sur le site de votre commune.