Jetons d'API
La page Jetons d'API vous permet de générer et gérer vos propres jetons d'accès pour utiliser l'API Quable PIM.
Important : Quable PIM affiche le jeton en clair une seule fois, immédiatement après sa création. Copiez-le et conservez-le en lieu sûr : vous ne pouvez plus le récupérer après la fermeture de cette fenêtre.
Prérequis
- Ouvrez la page Jetons d'API dans Quable PIM.
- Vérifiez que vous avez accès à la gestion des jetons. Les administrateurs y ont accès par défaut.
Niveaux d'accès
Deux niveaux d'accès sont disponibles à la création :
Accès Lecture (read)
read)Accorde un accès limité à l'API Quable PIM en lecture seule. Ce jeton ne permet pas d'ajouter, modifier ou supprimer du contenu.
Méthodes HTTP supportées : GET
Accès Lecture/Écriture (read_write)
read_write)Accorde un accès complet à l'API Quable PIM sans restriction. Ce jeton permet d'accéder à toutes les fonctionnalités de Quable PIM.
Méthodes HTTP supportées : GET POST PUT DELETE
Les administrateurs ont accès à la gestion des jetons par défaut.
Créer un jeton
- Cliquez sur Créer un jeton depuis la page de gestion.
- Renseignez les champs suivants :
- Nom (obligatoire) — Un nom descriptif pour identifier le jeton, ex.
Mon application. - Niveau d'accès (obligatoire) —
Lecture(read) ouLecture/Écriture(read_write). - Expiration (obligatoire) — Choisissez parmi : 1 jour, 1 semaine, 1 mois, 3 mois, 6 mois, 1 an, ou sans expiration.
- Nom (obligatoire) — Un nom descriptif pour identifier le jeton, ex.
- Cliquez sur Créer.
- Copiez immédiatement le jeton affiché. Après la fermeture de cette fenêtre, vous ne pouvez plus le consulter.
Gérer vos jetons
La liste affiche tous vos jetons avec les informations suivantes :
| Colonne | Description |
|---|---|
| Nom | Le nom que vous avez donné au jeton |
| Date de création | Date à laquelle le jeton a été créé |
| Niveau d'accès | Lecture (read) ou Lecture/Écriture (read_write) |
| Expiration | Date d'expiration, ou Jamais |
| Statut | Actif, Expiré ou Révoqué |
Révoquer un jeton
Vous pouvez révoquer uniquement les jetons au statut Actif.
- Cliquez sur l'icône de révocation sur la ligne du jeton souhaité.
- Dans la fenêtre de confirmation, saisissez
REVOKEpour confirmer.
- Cliquez sur Révoquer.
La révocation est définitive : elle invalide immédiatement le jeton, que vous ne pouvez pas réactiver.
Statuts des jetons
| Statut | Description |
|---|---|
| Actif | Le jeton est valide : vous pouvez l'utiliser |
| Expiré | La date d'expiration est dépassée |
| Révoqué | Le jeton a été révoqué |
Utiliser un jeton
Une fois copié, ajoutez le jeton à l'en-tête HTTP Authorization de vos requêtes :
Authorization: Bearer your_tokenL'URL de base de l'API Quable PIM est accessible en ajoutant /api à votre URL Quable PIM (ex. https://example.quable.com/api).
Pour tester via la documentation API interactive :
- Accédez à la documentation API et cliquez sur le bouton Authorize.
- Dans le champ Value, saisissez
Bearersuivi de votre jeton. - Cliquez sur Authorize pour activer la session.
N'oubliez pas de saisir le mot-clé
Bearersuivi d'un espace avant votre jeton.
En cas d'échec
- Si votre requête n'aboutit pas, vérifiez que l'en-tête
AuthorizationcontientBearersuivi d'un espace et du jeton copié lors de sa création. - Si le jeton est Expiré ou Révoqué, créez un nouveau jeton : un jeton révoqué ne peut pas être réactivé.
- Si une opération d'ajout, de modification ou de suppression échoue avec un jeton Lecture (
read), utilisez un jeton Lecture/Écriture (read_write).
Updated 7 days ago