Connexion Essayez gratuitement →

Plateforme · API REST

Une API REST, bornée par jeton

Lisez et alimentez Illizeo depuis vos outils : collaborateurs, absences, temps, documents, signatures, organisation, et les données de paie préparées pour votre logiciel de paie. Chaque jeton ne fait que ce que vous lui avez autorisé.

Essayez gratuitementEn parler avec nous

Ce que l’API couvre

Collaborateurs

Lister, consulter, créer et mettre à jour les dossiers. Export et effacement RGPD d’un collaborateur, pour répondre à une demande d’accès ou d’effacement.

Absences et temps

Lire et saisir les absences et les présences, pour brancher une badgeuse, un outil de planning ou un tableau de bord.

Documents et signatures

Déposer ou générer un document, lister par catégorie, lancer, relancer ou annuler une signature, télécharger l’original, le document signé et le certificat.

Organisation

Départements, équipes, postes, sites et pays : le référentiel que vos autres outils doivent partager avec Illizeo.

Paie, en lecture seule

Périodes, synthèse, salariés, salaires, absences, présences, changements et documents du mois. Illizeo prépare et exporte ; votre logiciel de paie calcule.

Exports planifiés

Lister les fichiers produits par vos rapports planifiés et les télécharger, plutôt que de les recevoir par e-mail.

Comment ça marche

Adresse
https://api.illizeo.app/v1/… — une seule adresse pour tous les clients : c’est le jeton qui désigne votre espace.
Authentification
Un jeton porteur (préfixe illz_), affiché une seule fois, à sa création ou à sa régénération.
Droits
Des scopes par ressource, en lecture ou en écriture : collaborateurs, absences, temps, documents, signatures, organisation, paie (lecture), exports planifiés (lecture).
Paie et exports
Le jeton agit sous l’identité de son créateur : il ne voit que le périmètre de paie et les rapports que cette personne voit.
Limite de débit
Facultative, réglée par jeton, de 1 à 10 000 requêtes par minute. Au-delà : réponse 429 avec Retry-After.
Expiration
Date d’expiration facultative. Un jeton expiré ou révoqué est refusé immédiatement.
Traçabilité
Journal d’utilisation conservé 90 jours, date et adresse IP de la dernière utilisation.
Contrat
Décrit en OpenAPI et vérifié par des tests : chaque route publiée y figure.

Ce que l’API ne fait pas, volontairement : supprimer un espace client. Ces actions restent dans l’application, derrière un administrateur connecté.

Gérer les jetons

Dans votre espace

Paramètres › Gérer Illizeo › Jetons API : création, choix des scopes, limite de débit, expiration, régénération et révocation. La documentation développeur se trouve dans votre espace Illizeo (menu Paramètres).

Deux droits distincts

Consulter les jetons (utile à un auditeur, qui voit la liste et la fiche) et les gérer (créer, modifier, régénérer, révoquer). L’accès API dépend de votre abonnement et reste ouvert pendant la période d’essai.

Besoin d’être prévenu d’un changement plutôt que d’interroger l’API à intervalles réguliers ? Voir les webhooks. Besoin de recevoir des fichiers sur votre serveur ? Voir les exports SFTP.

Connecter Illizeo à votre système d’information

En parler avec nous