Jetons API | Procurize.AI#

Générez, gérez et utilisez des jetons API pour un accès programmatique sécurisé à votre espace de travail Procurize.AI.

Applicable à : Tableau de bord Procurize.AI → Paramètres → Jetons
Disponible sur : Plans Business & Enterprise
Rôle requis : Responsable de la sécurité, Éditeur, Administrateur ou Mainteneur

Vue d’ensemble#

Les jetons API permettent un accès sécurisé et programmatique à la plateforme Procurize.AI. Vous pouvez les utiliser pour intégrer Procurize.AI à vos systèmes internes, automatiser des flux de travail ou créer des applications personnalisées sur la plateforme.

Caractéristiques principales :

Les jetons héritent de toutes les permissions de l’utilisateur qui les a créés
Les jetons sont limités à l’organisation – aucune nécessité de spécifier org dans les appels API
Un nombre illimité de jetons peut être généré
Les jetons peuvent avoir des dates d’expiration ou être configurés pour ne jamais expirer
Les jetons peuvent être désactivés puis réactivés si nécessaire

🔒 Note de sécurité : Procurize.AI ne stocke pas la valeur du jeton – uniquement son hachage. Vous devez copier et enregistrer le jeton immédiatement après sa génération. Il ne sera plus affiché.

Accéder au panneau de gestion des jetons#

Accédez à la page Tableau de bord → Jetons API.
Le panneau de gestion des jetons affiche vos jetons personnels associés à l’organisation actuelle.

Page des jetons API

Permission requise : Seuls les utilisateurs avec les rôles Responsable de la sécurité, Éditeur, Administrateur ou Mainteneur peuvent accéder à ce panneau. Pour les définitions détaillées des rôles, consultez la Vue d’ensemble des permissions .

Générer un nouveau jeton#

Saisissez un Nom pour identifier l’objectif du jeton.
Sélectionnez une période d’expiration :
- 1 mois
- 3 mois
- 1 an
- Pas d’expiration (validité illimitée)
Cliquez sur « Générer ».

Important – Copiez le jeton immédiatement#

Après la génération, la valeur du jeton est affichée une seule fois – copiez‑la et stockez‑la en lieu sûr (par ex., dans un gestionnaire de mots de passe ou une variable d’environnement).

Nouveau jeton API

⚠️ Vous ne pourrez plus voir la valeur du jeton. Procurize.AI ne conserve qu’un hachage sécurisé pour la vérification. Si vous perdez le jeton, vous devez le révoquer et en générer un nouveau.

Gérer les jetons existants#

Le panneau des jetons affiche une liste de tous les jetons générés avec leurs :

Nom
Suffixe
Date de création
Date d’expiration (ou « - »)
Statut : Actif ou Inactif

Désactivation / Réactivation d’un jeton#

Désactiver – désactive temporairement le jeton. Vous pouvez le réactiver plus tard si besoin.
Réactiver – restaure un jeton précédemment désactivé à l’état actif.

💡 La désactivation est utile pour suspendre temporairement des intégrations sans supprimer le jeton.

Révocation d’un jeton#

Révoquer – supprime définitivement le jeton. Cette action est irréversible.
Si vous perdez un jeton, révoquez‑le immédiatement et générez‑en un nouveau.

Utiliser un jeton API#

URL de base & Authentification#

Paramètre	Valeur
URL de base	`https://api.procurize.com`
Méthode d’authentification	Clé API via en‑tête
En‑tête	`X-API-Key: <VOTRE_JETON_API>`

Exemple de requête (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: VOTRE_JETON_API"

🧠 Aucun ID d’organisation requis – le jeton est lié à votre organisation, donc l’API résout le contexte automatiquement.

Règles importantes de sécurité et d’utilisation#

Règle	Explication
Permissions du jeton	Le jeton possède exactement les mêmes permissions que l’utilisateur qui l’a créé. Si le rôle de l’utilisateur change, les permissions du jeton sont mises à jour en conséquence.
Lien à l’organisation	Les jetons sont rattachés à l’organisation du créateur. Vous ne pouvez pas utiliser un même jeton sur plusieurs organisations.
Visibilité du jeton	La valeur du jeton n’est affichée qu’une seule fois. Enregistrez‑la immédiatement. Procurize.AI ne conserve qu’un hachage.
Jetons expirés	Les jetons expirés sont automatiquement désactivés et ne peuvent plus être utilisés. Générez un nouveau jeton si nécessaire.

Dépannage#

Problème	Solution
Erreur « Clé API invalide »	Vérifiez que le jeton a été copié correctement (sans espaces supplémentaires). Assurez‑vous qu’il est toujours actif et non expiré.
Le jeton ne fonctionne plus après un changement de rôle	Les permissions du jeton sont mises à jour pour correspondre au rôle actuel de l’utilisateur. Si l’utilisateur a perdu des permissions, le jeton les perd également.
Jeton perdu	Révoquez le jeton perdu et générez‑en un nouveau.
Limitation du débit	Les limites de débit de l’API s’appliquent selon votre plan. Consultez les en‑têtes `X-RateLimit-*` dans la réponse.

Sujets associés#

Vue d’ensemble des permissions – définitions détaillées des rôles
Plans tarifaires – quels plans incluent l’accès API
Référence de l’API REST – documentation détaillée des points de terminaison