Developers
Quable Guide

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 : Le jeton en clair n'est affiché qu'une seule fois, immédiatement après sa création. Copiez-le et conservez-le en lieu sûr. Il ne pourra pas être récupéré.

Niveaux d'accès

Deux niveaux d'accès sont disponibles à la création :

Accès Lecture (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)

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

  1. Cliquez sur Créer un jeton depuis la page de gestion.
  2. Renseignez les champs suivants :
    • Nom (obligatoire) — Un nom descriptif pour identifier le jeton, ex. Mon application.
    • Niveau d'accès (obligatoire) — Lecture ou Lecture/Écriture.
    • Expiration (obligatoire) — Choisissez parmi : 1 jour, 1 semaine, 1 mois, 3 mois, 6 mois, 1 an, ou sans expiration.
  1. Cliquez sur Créer.
  2. Copiez immédiatement le jeton affiché. Il ne sera plus visible après la fermeture de cette fenêtre.

Gérer vos jetons

La liste affiche tous vos jetons avec les informations suivantes :

ColonneDescription
NomLe nom que vous avez donné au jeton
Date de créationDate à laquelle le jeton a été créé
Niveau d'accèsLecture ou Lecture/Écriture
ExpirationDate d'expiration, ou Jamais
StatutActif, Expiré ou Révoqué

Révoquer un jeton

La révocation est uniquement disponible pour les jetons au statut Actif.

  1. Cliquez sur l'icône de révocation sur la ligne du jeton souhaité.
  2. Dans la fenêtre de confirmation, saisissez REVOKE pour confirmer.
  1. Cliquez sur Révoquer.
⚠️

La révocation est définitive. Le jeton sera immédiatement invalidé et ne pourra pas être réactivé.

Statuts des jetons

StatutDescription
ActifLe jeton est valide et peut être utilisé
ExpiréLa date d'expiration est dépassée
RévoquéLe jeton a été manuellement révoqué

Utiliser un jeton

Une fois copié, ajoutez le jeton à l'en-tête HTTP Authorization de vos requêtes :

Authorization: Bearer votre_jeton

L'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 :

  1. Accédez à la documentation API et cliquez sur le bouton Authorize.
  2. Dans le champ Value, saisissez Bearer suivi de votre jeton.
  3. Cliquez sur Authorize pour activer la session.
💡

N'oubliez pas de saisir le mot-clé Bearer suivi d'un espace avant votre jeton.

Updated 8 days ago