--- title: "Comment gérer les accès des partenaires par jeton ?" description: "Lire la liste des jetons d'API, en créer un pour un partenaire et le révoquer ; un jeton révoqué reste listé avec sa date et la personne qui l'a révoqué." url: https://docs.restoplus.net/parametrage/jetons-d-api/ --- # Comment gérer les accès des partenaires par jeton ? Un jeton d'API est une clé qu'un partenaire (un cabinet comptable, un outil de gestion…) présente à RestoPlus pour lire — ou écrire — vos données, sans compte d'utilisateur. Vous décidez quels écrans il peut toucher, avec quels droits, sur quels restaurants, et jusqu'à quelle date. Cet écran liste les jetons, en crée et les révoque. Une fois créé, un jeton ne change plus : pour modifier ses droits, on en crée un autre et on révoque le premier. ## Avant de commencer - Cet écran est réservé aux administrateurs : le super-administrateur et l'administrateur d'entreprise. - Un jeton ne donne jamais accès aux écrans d'administration : la liste des écrans ne les propose pas (« l'administration n'est jamais proposée »). - Sur chaque image, le cadre rouge montre où agir. Le numéro est celui de l'étape. ## Ouvrir l'écran L'écran se trouve dans la page **Paramétrage**. ### Étape 1 ![Jetons d'API (Paramétrage) : menu « Jetons d'API » pour accéder à l'écran](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-ecran.webp) **Action :** Dans le menu de gauche, cliquez sur **Paramétrage**, puis sur la carte **Jetons d'API**. Le titre est **Jetons d'API**, avec le sous-titre « Accès des intégrations partenaires à l'API, avec des droits limités et une date d'expiration ». Sans jeton : « Aucun jeton. » ## Lire la liste ### Étape 2 — **Jeton** ![Jetons d'API RestoPlus (Paramétrage) : vue d'ensemble de l'écran pour gérer les accès des partenaires par jeton](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-colonnes.webp) **Action :** Regardez l'en-tête de la liste : **Jeton**, **Droits**, **Expire le**, **Usage**, **Statut**. Aussi sur cette image : **Droits**, **Expire le**, **Usage**, **Statut**. - **À quoi ça sert :** Savoir ce que montre chaque colonne. ## Créer un jeton ### Étape 3 — **+ Nouveau jeton** ![Jetons d'API (Paramétrage) : bouton « + Nouveau jeton » pour ouvrir la fenêtre de création d'un jeton](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-nouveau.webp) **Action :** Cliquez sur **+ Nouveau jeton**. - **À quoi ça sert :** Ouvrir la fenêtre de création d'un jeton. ### Étape 4 ![Jetons d'API (Paramétrage) : fenêtre « Nouveau jeton d'API »](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-fenetre.webp) **Action :** Regardez la fenêtre **Nouveau jeton d'API**. Aussi sur cette image : **Écran**, **Consulter**, **Imprimer**, **Ajouter**, **Modifier**, **Supprimer**. Le texte dit : « Les droits et les restaurants sont figés à la création : pour en changer, créez un autre jeton puis révoquez celui-ci. » **Créer le jeton** reste grisé tant qu'il manque un nom, une date d'expiration ou au moins un droit. ### Étape 5 — **Nom** ![Jetons d'API (Paramétrage) : champ « Nom » pour reconnaître le jeton dans la liste](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-nom.webp) **Action :** Dans **Nom**, écrivez le nom du jeton. - **À quoi ça sert :** Reconnaître le jeton dans la liste. - **Obligatoire :** Oui. - **Exemple :** Essai comptabilité - **Si vous vous trompez :** Obligatoire : tant qu'il est vide, **Créer le jeton** reste grisé. 100 caractères au plus. ### Étape 6 — **Partenaire** ![Jetons d'API (Paramétrage) : champ « Partenaire » pour garder la trace de celui à qui la clé est confiée](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-partenaire.webp) **Action :** Dans **Partenaire**, écrivez qui recevra ce jeton. - **À quoi ça sert :** Garder la trace de celui à qui la clé est confiée. - **Obligatoire :** Non. - **Exemple :** Cabinet comptable (essai) - **Si vous vous trompez :** Facultatif. 100 caractères au plus. ### Étape 7 — **Expire le (obligatoire)** ![Jetons d'API (Paramétrage) : champ « Expire le (obligatoire) » pour limiter la durée de vie de la clé](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-expiration.webp) **Action :** Dans **Expire le (obligatoire)**, choisissez la date de fin. - **À quoi ça sert :** Limiter la durée de vie de la clé. - **Obligatoire :** Oui. - **Exemple :** 30/06/2027 - **Si vous vous trompez :** Obligatoire : sans date, **Créer le jeton** reste grisé. Dans le futur : « La date d'expiration doit être dans le futur. » Un jeton vit 366 jours au plus (réglable côté serveur) : « Un jeton vit … jours au plus : créez-en un nouveau à l'échéance. » La clé expire à la fin de ce jour. ### Étape 8 — **Autoriser l'écriture (ajouter, modifier, supprimer) — sinon lecture seule** ![Jetons d'API (Paramétrage) : case « Autoriser l'écriture (ajouter, modifier, supprimer) —… »](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-ecriture.webp) **Action :** Regardez la case **Autoriser l'écriture (ajouter, modifier, supprimer) — sinon lecture seule**. - **À quoi ça sert :** Décider si le partenaire peut seulement lire, ou aussi écrire. - **Obligatoire :** Non. Elle est décochée au départ : lecture seule. - **Exemple :** Décochée - **Si vous vous trompez :** Décochée, seules les cases **Consulter** et **Imprimer** sont possibles ; les autres sont grisées. Cochée, **Ajouter**, **Modifier** et **Supprimer** se débloquent. Décocher la case efface les cases d'écriture déjà cochées. ### Étape 9 — **Case d’un restaurant** ![Jetons d'API (Paramétrage) : bloc « Restaurants » pour limiter le jeton à certains restaurants](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-restaurants.webp) **Action :** Dans le bloc **Restaurants**, cochez les restaurants que le jeton peut toucher, ou laissez tout décoché. - **À quoi ça sert :** Limiter le jeton à certains restaurants. - **Obligatoire :** Non. - **Exemple :** Aucun coché : tous les restaurants - **Si vous vous trompez :** Le titre du bloc dit le choix : « aucun coché : tous les restaurants de l'entreprise », ou le nombre de restaurants cochés. Chaque ligne cite le numéro de magasin du restaurant. Un restaurant introuvable est refusé : « Un des restaurants choisis est introuvable. » ### Étape 10 — **Filtrer…** ![Jetons d'API (Paramétrage) : bloc « Écrans accessibles » pour choisir les écrans que le partenaire pourra lire ou modifier](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-ecrans.webp) **Action :** Regardez le bloc **Écrans accessibles**. - **À quoi ça sert :** Choisir les écrans que le partenaire pourra lire ou modifier, et ce qu'il peut y faire. - **Obligatoire :** Oui : au moins un droit sur un écran. - **Exemple :** Appels d'offres : Consulter - **Si vous vous trompez :** Le titre donne le nombre d'écrans cochés et rappelle : « l'administration n'est jamais proposée ». Sans aucun droit coché, **Créer le jeton** reste grisé. Chaque ligne est un écran (son adresse et sa description), avec cinq cases : **Consulter**, **Imprimer**, **Ajouter**, **Modifier**, **Supprimer**. ### Étape 11 ![Jetons d'API (Paramétrage) : champ « Filtrer… » pour créer un jeton](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-filtre-ecrans.webp) **Action :** Dans **Filtrer…**, tapez un mot. ### Étape 12 — **Case de droit d’un écran** ![Jetons d'API (Paramétrage) : case « Consulter » pour accorder un droit sur cet écran au partenaire](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-droit.webp) **Action :** Cochez, par exemple, **Consulter** sur un écran. - **À quoi ça sert :** Accorder un droit sur cet écran au partenaire. - **Obligatoire :** Non. - **Exemple :** Consulter - **Si vous vous trompez :** Les cases d'écriture restent grisées tant que l'écriture n'est pas autorisée plus haut. ## La clé du jeton ### Étape 13 — **Créer le jeton** ![Jetons d'API (Paramétrage) : bouton « Créer le jeton » pour créer le jeton et obtenir sa clé](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-creer.webp) **Action :** Cliquez sur **Créer le jeton**. - **À quoi ça sert :** Créer le jeton et obtenir sa clé. Une fenêtre **Jeton créé** s'ouvre avec la clé. ### Étape 14 — **×** ![Jetons d'API (Paramétrage) : fenêtre « Jeton créé » pour récupérer la clé : c'est le seul moment où elle est visible](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-cle-creee.webp) **Action :** Lisez la fenêtre **Jeton créé**. Copiez la clé avec **Copier la clé**, puis fermez avec la croix. Aussi sur cette image : **Copier la clé**. - **À quoi ça sert :** Récupérer la clé : c'est le seul moment où elle est visible. Le texte dit : « Copiez la clé maintenant : elle ne sera plus jamais affichée. Perdue, il faudra créer un autre jeton. » La clé de l'image est floutée. Le partenaire l'envoie dans l'en-tête de chaque appel ; elle expire à la date choisie. Transmettez-la par un canal sûr. ### Étape 15 — **Révoquer** ![Jetons d'API (Paramétrage) : bouton « Révoquer » pour vérifier le jeton créé et savoir comment l'arrêter](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-liste-apres.webp) **Action :** Regardez la ligne du nouveau jeton, et le bouton **Révoquer**. - **À quoi ça sert :** Vérifier le jeton créé et savoir comment l'arrêter. Le statut est « Actif » ; le début de la clé suit le partenaire, entre guillemets de code. ## Révoquer un jeton ### Étape 16 ![Jetons d'API (Paramétrage) : bouton « Révoquer »](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-revoquer.webp) **Action :** Cliquez sur **Révoquer**. Une confirmation s'ouvre. ### Étape 17 ![Jetons d'API (Paramétrage) : fenêtre « Révoquer le jeton »](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-revoquer-confirmation.webp) **Action :** Lisez la fenêtre **Révoquer le jeton**, puis cliquez sur **Révoquer** (ou **Annuler**). Aussi sur cette image : **Annuler**, **Révoquer**. Le texte dit : « « … » sera refusé dès son prochain appel. C'est définitif. » ### Étape 18 ![Jetons d'API (Paramétrage) : la ligne du jeton révoqué](https://docs.restoplus.net/parametrage/jetons-d-api/jetons-d-api-revoque.webp) **Action :** Regardez la ligne du jeton révoqué. Son statut est « Révoqué », avec la date et la personne qui l'a révoqué. Le jeton reste dans la liste, sans bouton.