En bref : publiez vos demandes de journaliers et récupérez vos feuilles de temps depuis votre propre logiciel, et recevez une notification signée à chaque arrivée pointée. Réservé aux entreprises inscrites sur FIABO.
Obtenir une clé
L’administrateur de l’entreprise crée une clé dans son espace : API et donneurs d’ordre › Créer une clé. La clé (fiabo_…) n’est affichée qu’une fois ; FIABO n’en garde qu’une empreinte. Une clé révoquée cesse de fonctionner immédiatement. Les demandes publiées avec une clé le sont au nom de la personne qui l’a créée.
Chaque appel porte l’en-tête :
Authorization: Bearer fiabo_votre_cle
Adresse de base : https://fiabo.pro/api/entreprises/v1. Réponses en JSON, dates au format ISO 8601, montants en francs CFA sans décimales. Limite : 60 appels par minute. Chaque appel est journalisé.
Ce que l’API permet
| Méthode | Chemin | Rôle |
|---|---|---|
| GET | /chantiers |
Vos chantiers (identifiant, nom, adresse) |
| GET | /demandes |
Vos 100 dernières demandes ; filtre ?status=open, filled ou cancelled |
| POST | /demandes |
Publier une demande express |
| GET | /demandes/{id} |
Une demande et ses travailleurs confirmés : prénom et initiale, badges datés, arrivée pointée ou non |
| POST | /demandes/{id}/annuler |
Annuler une demande ; les travailleurs confirmés sont prévenus |
| GET | /feuilles-de-temps?site_id=…&week=AAAA-MM-JJ |
La semaine d’un chantier : arrivée, départ et heures par jour et par travailleur |
| GET | /paies?from=AAAA-MM-JJ&to=AAAA-MM-JJ |
Les paies déclarées et la réponse de chaque travailleur |
Le numéro de téléphone d’un travailleur n’est jamais transmis par l’API.
Publier une demande
POST /api/entreprises/v1/demandes
{
"site_id": 12,
"trade": "manoeuvre",
"headcount": 6,
"starts_on": "2026-11-10",
"starts_at": "07:00",
"pay": 5000,
"verified_only": true,
"with_team_leader": false,
"description": "Coulage de dalle, apporter des gants"
}
Les règles sont celles de l’espace entreprise : aucun critère discriminatoire dans la description (la demande est refusée sinon), une heure de début à venir, une paie par jour versée directement par vous au travailleur. La réponse (201) contient la demande créée ; l’offre part aussitôt aux travailleurs vérifiés les plus proches.
Notifications automatiques (webhooks)
Dans API et donneurs d’ordre › Notifications, indiquez une adresse https publique et les événements voulus :
| Événement | Quand |
|---|---|
request.filled |
Une demande est pourvue |
worker.arrived |
Un travailleur pointe son arrivée sur un de vos chantiers |
wage.confirmed |
Un travailleur confirme avoir reçu la paie déclarée |
FIABO envoie un POST en JSON : {"event": "...", "id": "...", "sent_at": "...", "data": {...}}, avec les en-têtes X-Fiabo-Event, X-Fiabo-Timestamp et X-Fiabo-Signature. Répondez par un code 2xx ; sinon FIABO réessaie après 1 minute, puis après 5 minutes.
Vérifier la signature
La signature est un HMAC SHA-256 de horodatage.corps avec votre secret (whsec_…, affiché une seule fois, renouvelable). Refusez un message dont l’horodatage a plus de 5 minutes.
$attendue = 'sha256='.hash_hmac('sha256', $_SERVER['HTTP_X_FIABO_TIMESTAMP'].'.'.file_get_contents('php://input'), $secret);
$valide = hash_equals($attendue, $_SERVER['HTTP_X_FIABO_SIGNATURE'])
&& abs(time() - (int) $_SERVER['HTTP_X_FIABO_TIMESTAMP']) < 300;
Le bouton Envoyer un test envoie l’événement test pour vérifier votre installation.
Donneurs d’ordre
Une entreprise qui sous-traite (BTP, nettoyage, gardiennage) peut suivre la façon dont ses sous-traitants traitent leurs travailleurs. C’est le sous-traitant qui donne l’accès, depuis son espace, avec le numéro RCCM de son client, et qui peut le retirer à tout moment.
Le donneur d’ordre voit, sur les 30 derniers jours et pour chaque sous-traitant : le nombre de travailleurs, la part dont l’identité est vérifiée, les journées pointées, la part des paies confirmées par les travailleurs, les paies contestées et les signalements fondés. Jamais le nom ni le numéro d’un travailleur.
Contact
Une question technique : contact@fiabo.pro.
Mis à jour le 03/11/2026