Intégration · Données

L'API eBrigade

Vos données d'équipe, disponibles dans vos autres outils. Douze jeux de données en lecture, trois en écriture, une clé, du JSON. De quoi brancher eBrigade sur votre SIRH, votre outil de paie, votre entrepôt de données ou votre catalogue de formation.

En résumé : l'API d'eBrigade est une API REST en JSON, authentifiée par clé. Elle sert à ne plus ressaisir deux fois la même chose — l'annuaire du personnel arrive du SIRH, les heures pointées repartent vers la paie, les habilitations validées par l'organisme de formation remontent sur les fiches. La documentation complète, champ par champ, est dans votre instance.

Ce que l'API vous donne à lire

Personnes

Fiches du personnel et des bénévoles : identité, organisation de rattachement, statut, date d'engagement, coordonnées, compétences détenues, champs personnalisés. Recherche par nom, identifiant, e-mail, téléphone ou identifiant externe.

Activités

Une ligne par créneau d'activité : type, libellé, organisation, dates et horaires de début et de fin. Filtrable par période, par organisation et par type.

Participations

Qui est inscrit sur quelle activité, sur quel créneau, à quel poste.

Pointages

Entrées et sorties horodatées, par personne et par activité. C'est la matière première d'une paie ou d'une valorisation du bénévolat.

Disponibilités

Créneaux déclarés par chaque membre sur la période demandée.

Absences

Indisponibilités et congés, avec leur type et leur statut de validation.

Compétences

Le référentiel des compétences et des formations de votre organisation.

Habilitations détenues

Qui détient quoi, avec la date d'échéance — et de quoi lister ce qui expire avant une date donnée.

Organisations

L'arborescence de vos entités : sections, comités, unités locales, agences.

Véhicules

Le parc, par organisation, avec son type et son immatriculation.

Matériel

L'inventaire, par organisation, par type et par lieu de stockage.

Inscriptions

Les inscriptions aux activités payantes sur la période demandée.

Toutes ces lectures sont paginées et filtrables. Celles qui bougent le plus acceptent un paramètre « modifié depuis », pour ne rapatrier que ce qui a changé.

Ce que l'API accepte en écriture

  • Créer et mettre à jour des personnes Votre SIRH, votre annuaire ou votre outil de recrutement reste la source ; eBrigade suit. Jusqu'à 200 fiches par appel, identifiant interne ou identifiant externe au choix.
  • Créer une activité Une session de formation programmée dans votre catalogue arrive dans le planning eBrigade avec ses créneaux et ses inscrits.
  • Poser des compétences Un organisme de formation valide un PSE1, une habilitation électrique, un permis : la qualification et sa date d'échéance arrivent sur la fiche.

Modifier sans casser. Un appel PATCH n'écrit que les champs que vous lui donnez : changer un matricule sur cinquante fiches ne touche ni aux coordonnées, ni à l'adresse, ni à la personne à prévenir, ni aux droits d'accès. L'appel historique, qui remplace la fiche entière, reste disponible pour les intégrations qui poussent des fiches complètes.

Ce qui compte quand on branche deux systèmes

Mise à jour partielle

Changer un matricule sur cinquante fiches sans toucher au reste : un PATCH n'écrit que les champs que vous envoyez. Le reste de la fiche — coordonnées, adresse, personne à prévenir, droits d'accès — n'est pas effleuré.

Synchronisation incrémentale

Un paramètre « modifié depuis » sur les jeux qui bougent le plus : vous ne rapatriez que le delta, pas l'annuaire entier toutes les nuits.

Une enveloppe JSON stable

Toutes les réponses ont la même forme : un indicateur de succès, les données, et un bloc de pagination. Les erreurs nomment le champ fautif, une ligne par problème.

Des clés que vous maîtrisez

Deux clés distinctes, une pour la lecture et une pour l'écriture, régénérables à tout moment depuis le paramétrage. Vous pouvez en plus restreindre l'accès à une liste d'adresses IP.

Consommation visible

Une jauge dans le paramétrage montre la consommation du jour en direct, et chaque réponse porte le quota restant dans ses en-têtes. 10 000 appels par jour, 60 par minute.

Aucun prérequis serveur

Trois formes d'URL équivalentes, dont une qui fonctionne sans réécriture d'URL ni configuration particulière. Vous branchez, ça répond.

Quatre branchements que nos clients font vraiment

  • Le SIRH pousse, eBrigade suit Les arrivées, les départs et les changements d'affectation sont saisis une seule fois, dans l'outil RH. eBrigade reçoit les fiches et se charge du terrain : disponibilités, planning, mobilisation, habilitations.
  • L'organisme de formation ferme la boucle Une session validée met à jour les qualifications et leurs échéances. Plus de tableur de suivi des recyclages, et une affectation bloquée automatiquement quand une habilitation est périmée.
  • La BI se sert toute seule Pointages, participations et heures partent vers votre entrepôt de données ou votre tableau de bord — Power BI, Metabase, Looker Studio — sans export manuel ni fichier qui traîne.
  • La paie récupère les heures Les entrées et sorties horodatées alimentent la préparation de paie ou la valorisation du bénévolat de votre rapport d'activité.

Démarrer : trois étapes

  1. Activez l'API depuis le paramétrage de votre instance, puis générez vos clés — une pour la lecture, une pour l'écriture.
  2. Lisez la documentation intégrée : elle liste chaque ressource, chaque champ et son format, avec des exemples prêts à copier. Elle est dans votre eBrigade, à jour de votre version.
  3. Faites votre premier appel avec votre clé dans l'en-tête Authorization. Si la réponse vous plaît, il ne reste qu'à l'automatiser.

Vous préférez ne pas écrire le code ? Dites-nous ce que vous voulez brancher : nous chiffrons l'intégration, ou nous vous mettons en relation avec un intégrateur qui connaît déjà eBrigade.

Questions fréquentes

L'API eBrigade est-elle comprise dans l'abonnement ?
L'API fait partie des modules d'eBrigade et s'active depuis le paramétrage de votre instance. Selon votre offre, elle est déjà comprise ; sinon elle s'ajoute à votre abonnement. Le plus simple est de nous poser la question : la réponse tient en un message.
Comment s'authentifie-t-on sur l'API eBrigade ?
Par une clé transmise dans l'en-tête HTTP Authorization, sous la forme Bearer votre_clé. Deux clés distinctes existent, une pour la lecture et une pour l'écriture, toutes deux générées et régénérables depuis le paramétrage de votre instance. Une restriction par adresse IP peut être activée en complément.
Peut-on modifier un seul champ d'une fiche sans écraser le reste ?
Oui. Un appel PATCH sur une fiche existante n'écrit que les champs présents dans le corps de la requête : seul l'identifiant est obligatoire, et tout ce que vous n'envoyez pas reste tel quel. L'appel POST historique, lui, écrit la fiche entière — il est fait pour un logiciel qui pousse des fiches complètes.
Quelles données l'API eBrigade expose-t-elle ?
Douze jeux de données en lecture : personnes, activités, participations, pointages, disponibilités, absences, compétences, habilitations détenues, organisations, véhicules, matériel et inscriptions. Trois en écriture : création et mise à jour de personnes, création d'activités, pose de compétences sur des membres.
Y a-t-il une limite au nombre d'appels à l'API ?
10 000 appels par jour et 60 par minute. Chaque réponse indique le quota restant dans ses en-têtes, et une jauge dans le paramétrage montre la consommation du jour en direct. Un import accepte jusqu'à 200 fiches par appel.
Faut-il un développeur pour brancher eBrigade sur notre système d'information ?
Pour écrire l'intégration, oui — c'est une API REST classique, en JSON, documentée dans votre instance avec la liste des champs et des exemples prêts à copier. Beaucoup de nos clients la branchent depuis un outil d'automatisation sans écrire de code. Si vous préférez nous confier le travail, c'est possible sur devis.
En images

Le produit, tel que vos équipes le voient

Les données que l'API expose sont celles que vos équipes manipulent au quotidien.

eBrigade — clés d'api et quotas : Une clé pour les flux entrants, une autre pour les flux sortants, régénérables en un clic, avec la consommation du jour et la limite en vigueur.
Clés d'API et quotasUne clé pour les flux entrants, une autre pour les flux sortants, régénérables en un clic, avec la consommation du jour et la limite en vigueur.
eBrigade — les endpoints documentés : Personnel, activités, participations, compétences, organisations, disponibilités : chaque ressource avec sa méthode et ses paramètres.
Les endpoints documentésPersonnel, activités, participations, compétences, organisations, disponibilités : chaque ressource avec sa méthode et ses paramètres.
eBrigade — exemples d'appels prêts à copier : Requêtes et réponses complètes pour chaque flux : votre équipe technique n'a pas à deviner le format attendu.
Exemples d'appels prêts à copierRequêtes et réponses complètes pour chaque flux : votre équipe technique n'a pas à deviner le format attendu.

Vous avez déjà un SIRH, un outil de paie, un entrepôt de données ?

Branchez eBrigade dessus plutôt que de ressaisir. 30 jours gratuits, sans carte bancaire.

Essai gratuit 30 jours Sans CB · Sans engagement · Espace prêt en 2 min