---
title: Créer et gérer les jetons API
description: Créer un jeton pour un logiciel tiers, choisir ses droits, son expiration et sa limite, puis le modifier, le régénérer, le désactiver ou le révoquer.
url: "https://illizeo.com/centre-aide/api-gerer-les-jetons/"
updated: "2026-11-05"
category: Plateforme / API REST
---

# Créer et gérer les jetons API

Un jeton API permet à un logiciel tiers (paie, annuaire, planning, entrepôt de données) de lire ou d'écrire vos données Illizeo par l'API publique, dans les droits que vous lui accordez. Cet article explique comment créer un jeton, le transmettre, le modifier, le régénérer, le suspendre et le révoquer. Il s'adresse aux administrateurs de l'espace.

## Avant de commencer

- L'écran se trouve dans **Paramètres › Gérer Illizeo › Jetons API**. L'entrée n'apparaît que si votre abonnement comprend l'accès à l'API (il est ouvert pendant la période d'essai) et si l'un de vos rôles porte le droit « Voir les tokens API ».
- Créer, modifier, régénérer, désactiver ou révoquer un jeton demande en plus le droit « Créer / éditer / révoquer un token » au palier **Exécuter**. Sans lui, la liste et les fiches se lisent, mais aucun bouton d'action n'apparaît.
- Par défaut, seul le rôle Administrateur porte ces deux droits. Ils se règlent dans **Paramètres › Gérer les employés › Rôles des employés** (voir [Permissions & rôles](https://illizeo.com/docs-category/plateforme-fr/plateforme-roles-permissions/)).

## Un jeton agit au nom de son créateur

Un jeton n'a pas de droits à lui : il hérite des droits et du périmètre de la personne qui l'a créé, jamais plus. Un appel qui lit les collaborateurs ne voit que ceux que cette personne voit dans l'application ; une écriture exige le même droit que le geste équivalent à l'écran. Les droits cochés sur le jeton viennent en plus : ils limitent ce que le jeton peut appeler.

- Si les droits du créateur changent, ceux du jeton changent avec eux, dès l'appel suivant.
- Si le compte du créateur n'est plus actif (départ, suspension), le jeton cesse de fonctionner.
- Un autre administrateur peut modifier ou régénérer le jeton : celui-ci continue d'agir au nom de son créateur.

Créez donc chaque jeton avec un compte dont les droits correspondent à ce que l'intégration doit voir.

## La liste des jetons

La page affiche d'abord la carte **Plateforme API**, qui résume la consommation de la période (voir [Suivre l'utilisation d'un jeton et le dépanner](https://illizeo.com/centre-aide/api-suivre-et-depanner-un-jeton/)), puis le tableau des jetons :

- **Nom**, avec la date de création et son auteur ;
- **Jeton** : le début de la valeur seulement, suivi d'astérisques ;
- **Droits** : les trois premiers, les autres au survol de la pastille « +n » ; les droits d'écriture sont colorés ;
- **Créé par**, **Dernière utilisation** (avec la date d'expiration), **Statut** et **Actions**.

Le champ **Rechercher** filtre par nom. Le bouton **Documentation** ouvre la documentation de l'API, décrite dans [API publique : le guide du développeur](https://illizeo.com/centre-aide/api-guide-du-developpeur/).

![La page Paramètres, Gérer Illizeo, Jetons API d'un espace encore sans jeton : en haut la carte Plateforme API avec la consommation de la période, puis le bloc Jetons API avec les boutons Rechercher, Documentation et Nouveau jeton, et l'état vide Aucun jeton API avec le bouton Créer le premier jeton](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/api-gerer-les-jetons-01.fr_.png?resize=800%2C500&quality=80&ssl=1)
Paramètres › Gérer Illizeo › Jetons API.

## Créer un jeton

1. Cliquez sur **Nouveau jeton** (ou **Créer le premier jeton** si la liste est vide).
2. **Nom** (obligatoire, 100 caractères au plus) : nommez le système qui utilisera le jeton, par exemple « Synchronisation paie ». Vous le reconnaîtrez ainsi dans le journal d'utilisation. Deux jetons non révoqués ne peuvent pas porter le même nom ; l'écran le signale pendant la saisie.
3. **Expiration (optionnelle)** : choisissez une date ; le jeton cesse de fonctionner à la fin de ce jour. Laissé vide, il n'expire jamais.
4. **Limite de débit (requêtes / minute)** : de 1 à 10 000. Laissé vide, le jeton reçoit la limite par défaut indiquée sous le champ (60 requêtes par minute).
5. **Droits** (au moins un) : cochez, ressource par ressource, **Lire** et/ou **Écrire**.
6. Cliquez sur **Créer le jeton**.

![Le formulaire Nouveau jeton API : encadré rappelant que le jeton agit au nom de son créateur, champ Nom rempli avec Synchronisation paie, champs Expiration (optionnelle) et Limite de débit (requêtes / minute) avec l'aide sur les limites, puis le début de la liste des droits](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/api-gerer-les-jetons-02.fr_.png?resize=800%2C500&quality=80&ssl=1)
Le formulaire de création d'un jeton.

Les ressources sont rangées en deux groupes, **Données** et **Référentiel**. Dans chaque groupe, **Tout en lecture** coche toutes les lectures et **Effacer** décoche tout le groupe. Seules les ressources des modules activés dans votre espace sont proposées : Planification, Annualisation, Budget, BDESE, Paie suisse ou Flex Office n'apparaissent que si le module l'est. Ce que chaque droit ouvre est détaillé dans le guide du développeur.

![Le groupe Données du sélecteur de droits après Tout en lecture : une ligne par ressource (Collaborateurs, Absences, Temps et présences, Planification, Documents, Paie…), la case de lecture cochée, la case d'écriture vide, et un tiret là où le sens n'existe pas pour la ressource](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/api-gerer-les-jetons-03.fr_.png?resize=800%2C523&quality=80&ssl=1)
Les droits d'un jeton, groupe Données, après « Tout en lecture ».

## Copier le jeton, une seule fois

Une fois le jeton créé, la fenêtre **Votre jeton API** affiche sa valeur complète (elle commence par `illz_`) et un exemple d'appel. Copiez la valeur avec le bouton de copie, transmettez-la par un canal sûr à la personne qui configure l'intégration, puis cliquez sur **Je l'ai enregistré**.

Cette valeur n'est plus jamais affichée : Illizeo n'en garde qu'une empreinte. Si elle est perdue, régénérez le jeton.

## Modifier un jeton

L'icône **Modifier** de la liste, ou le bouton **Modifier** de la fiche, ouvre la page **Modifier le jeton API**. Vous pouvez y changer le nom, l'expiration, la limite de débit et les droits, puis cliquer sur **Enregistrer**. Les changements valent dès l'appel suivant ; la valeur du jeton, elle, ne change pas.

## Régénérer un jeton

Le bouton **Régénérer le jeton**, sur la fiche ou sur la page de modification, demande une confirmation puis émet une nouvelle valeur. L'ancienne cesse de fonctionner immédiatement ; les droits, l'expiration et la limite de débit sont conservés. La nouvelle valeur s'affiche une seule fois, dans la fenêtre **Votre nouveau jeton** : mettez l'intégration à jour aussitôt.

## Désactiver ou révoquer

- **Désactiver** : l'interrupteur de la colonne **Statut** suspend le jeton, dont les appels sont alors refusés. Rebasculez-le pour le réactiver. C'est le bon geste pour couper une intégration le temps d'une vérification.
- **Révoquer** : l'icône **Révoquer** ouvre la confirmation **Révoquer le jeton API**. La révocation est définitive : toute intégration qui utilise le jeton perd l'accès immédiatement. Le jeton reste dans la liste avec le statut **Révoqué**, pour l'historique ; il ne peut plus être modifié, régénéré ni réactivé. Son nom redevient disponible pour un nouveau jeton.

![La boîte de confirmation Révoquer le jeton API : question avec le nom du jeton, avertissement que l'action est définitive et que toute intégration perd l'accès immédiatement, boutons Annuler et Révoquer](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/api-gerer-les-jetons-04.fr_.png?resize=448%2C372&quality=80&ssl=1)
La confirmation de révocation.

## À savoir

- Un jeton dont la date d'expiration est passée affiche le statut **Expiré** et ses appels sont refusés ; chaque nuit, Illizeo le passe aussi en inactif. Pour le remettre en service, modifiez-le avec une nouvelle date d'expiration (ou sans date), enregistrez, puis réactivez-le dans la liste s'il apparaît inactif.
- Les créations, modifications, activations et désactivations à la main, régénérations et révocations de jetons sont tracées dans **Paramètres › Gérer Illizeo › Logs utilisateurs**. La valeur d'un jeton n'y figure jamais, seulement le fait qu'elle a changé.
- Un lien venu de la page d'intégrations d'un module peut ouvrir ce formulaire avec un nom et des droits déjà proposés. Rien n'est créé tant que vous ne cliquez pas sur **Créer le jeton**.
- Si votre abonnement ne comprend pas l'accès à l'API, la page l'indique et propose **Voir les forfaits**.

## Questions fréquentes

### Je ne vois pas le bouton « Nouveau jeton ».

Il demande le droit « Créer / éditer / révoquer un token » au palier Exécuter.

### J'ai perdu la valeur d'un jeton.

Elle ne peut pas être réaffichée. Régénérez le jeton et transmettez la nouvelle valeur à l'intégration.

### Faut-il un jeton par intégration ?

C'est préférable : chaque jeton a son nom, ses droits, sa limite et son journal d'utilisation, et se révoque sans couper les autres intégrations.

### *Similaire*