Pour les besoins non couverts par le marketplace, Illizeo expose une API REST documentée OpenAPI 3.1. Authentification OAuth 2.0 ou clé API, rate limit raisonnable, webhooks bidirectionnels.
Endpoints principaux #
| Domaine | Verbes | Quotas |
|---|---|---|
| /v1/employees | GET, POST, PATCH, DELETE | 10 000 / heure |
| /v1/leaves | GET, POST, PATCH | 10 000 / heure |
| /v1/payroll | GET | 1 000 / heure |
| /v1/documents | GET, POST | 5 000 / heure |
| /v1/attendance | GET, POST | 50 000 / heure |
Procédure pas à pas #
-
Créer une application #
Paramètres → API → Applications → Nouvelle. Nom, scopes, IP autorisées (optionnel).
-
Récupérer les credentials #
Client ID + Client Secret OAuth, ou clé API simple. Le Secret n’est affiché qu’une fois, stockez-le immédiatement dans votre coffre.
-
Tester avec curl ou Postman #
Collection Postman fournie. Exemples curl dans la documentation.
-
Implémenter #
SDK officiels : Node.js, Python, PHP, Java. Communautaire : Go, Ruby, .NET.
-
Monitorer #
Dashboard API Usage : appels, latence P95, erreurs 4xx/5xx, quota restant.
Format des données #
Toutes les réponses sont en JSON. Pagination cursor-based (RFC 5988). Erreurs RFC 7807 (Problem Details). Filtres URL standards : ?filter[status]=active&sort=-created_at&page[size]=50.
FAQ #
API pour quel cas d’usage ?
Synchronisation avec un SI maison, export vers BI, automatisation HR (créer fiche depuis ATS, etc.).
Versionnage ?
v1 stable. Préavis de 12 mois avant deprecation. Communiqué dans le changelog.
Sandbox ?
Tenant sandbox gratuit avec données fictives. Idéal pour développer sans risque.
Authentification recommandée ?
OAuth 2.0 pour les apps utilisateurs. Clé API pour les jobs serveur-à-serveur.
Voir Webhooks et événements #
Recevez les événements Illizeo en temps réel.
