---
title: "Supprimer une clé d'API"
weight: 10
description: "Révoquer un jeton d'API sur le serveur OCR : retrouver la clé concernée et la supprimer définitivement."
---

# Supprimer une clé d'API

Une clé d'API (ou jeton d'API) autorise une application à utiliser le serveur OCR en votre nom : application mobile, plugin Dolibarr, script ou intégration tierce. Chaque clé est rattachée à votre compte.

Vous pouvez supprimer une clé à tout moment. Supprimez une clé lorsque :

- l'application qui l'utilisait n'est plus en service ;
- vous soupçonnez que la clé a été divulguée ou compromise ;
- vous faites le ménage parmi des clés de test ou inutilisées.

> **Attention :** la suppression d'une clé d'API est **définitive et immédiate**. Toute application qui s'authentifie encore avec cette clé sera instantanément refusée. Assurez-vous d'avoir mis à jour ou arrêté l'application concernée avant de supprimer sa clé. Le serveur ne conserve que l'empreinte publique de la clé : il est impossible de retrouver ou de réémettre une clé supprimée.

## Accéder à la liste des jetons d'API

1. Connectez-vous à l'administration du serveur OCR (adresse `/admin`).
2. Dans le menu latéral de gauche, cliquez sur **Jetons d'API**.

La liste affiche les clés rattachées à votre compte, avec les colonnes suivantes :

| Colonne | Description |
|---------|-------------|
| **Name** | Nom donné à la clé lors de sa création. |
| **Keyword** | Mot-clé associé à la clé (par exemple le nom du client ou de l'application). |
| **Created** | Date de création de la clé. |
| **Last used** | Date de dernière utilisation, utile pour repérer les clés inactives. |

![Liste des jetons d'API avec les colonnes Name, Keyword, Created et Last used](screenshots/liste-jetons-api.webp)

Selon votre profil, l'étendue de la liste varie :

- **Utilisateur standard** : vous ne voyez que vos propres clés.
- **Revendeur** : vous voyez vos clés et celles de vos clients (une colonne supplémentaire indique l'utilisateur propriétaire).
- **Super-administrateur** : vous voyez l'ensemble des clés du serveur.

## Retrouver la clé à supprimer

Si vous avez beaucoup de clés, utilisez la **barre de recherche** en haut de la liste. La recherche porte sur le nom, le mot-clé et l'empreinte de la clé. Vous pouvez aussi cliquer sur l'en-tête d'une colonne pour trier la liste (par exemple par **Last used** afin de repérer les clés jamais utilisées).

Identifiez la ligne correspondant à la clé que vous souhaitez révoquer avant de poursuivre. Vérifiez le nom et le mot-clé pour ne pas supprimer une clé encore active.

## Supprimer la clé

1. Cliquez sur la ligne de la clé concernée pour ouvrir sa fiche.
2. Vérifiez le nom et l'empreinte affichés afin de confirmer qu'il s'agit bien de la bonne clé.
3. Cliquez sur le bouton de suppression (icône de corbeille).
4. Confirmez la suppression dans la fenêtre qui s'affiche.

![Fiche d'un jeton d'API avec le bouton de suppression](screenshots/fiche-jeton-suppression.webp)

La clé disparaît immédiatement de la liste. À partir de cet instant, toute requête présentant cette clé est rejetée par le serveur.

## Après la suppression

- L'application qui utilisait la clé ne pourra plus se connecter : elle affichera une erreur d'authentification.
- Pour rétablir l'accès, créez une **nouvelle clé** depuis la même page **Jetons d'API**, puis renseignez-la dans l'application concernée.
- Lors de la création d'une nouvelle clé, le serveur n'affiche la valeur complète **qu'une seule fois** : copiez-la et conservez-la en lieu sûr immédiatement, elle ne pourra plus être réaffichée ensuite.

## Questions fréquentes

### Puis-je récupérer une clé supprimée ?

Non. La suppression est définitive et le serveur ne stocke que l'empreinte publique de la clé. Vous devez créer une nouvelle clé.

### La suppression affecte-t-elle mon abonnement ou mes quotas ?

Non. Supprimer une clé ne modifie ni votre abonnement ni vos quotas. Seul l'accès via cette clé précise est révoqué. Mais par contre votre facture sera probablement impactée: sauf accord spécifique toute clé d'api supplémentaire est facturée il est donc important de supprimer les clés inutilisées.

### Comment savoir si une clé est encore utilisée ?

Consultez la colonne **Last used** : une date ancienne (ou absente) indique une clé peu ou jamais utilisée, donc plus sûre à supprimer.