Aller au contenu
Screeb Help CenterCentre d'aide
Ouvrir Screeb

Obtenir votre clé API Screeb

Trouvez la clé API de votre workspace, utilisez-la pour envoyer des données et des releases à Screeb depuis votre backend, et réinitialisez-la en cas de fuite.

Guide pratique3 min de lecture, mis à jour le 15 oct. 2026

La clé API du workspace permet à vos propres serveurs de dialoguer avec Screeb, sans le tag ni un SDK mobile. Chaque workspace a une clé.

  • La page Screeb API et la réinitialisation de la clé sont réservées aux membres qui ont le rôle Admin dans l’organisation.
  • Un Éditeur ou un Admin du workspace peut copier la clé depuis Releases, voir Réinitialiser la clé. Un Analyste ne la voit pas.
  • La clé est un secret : qui la détient peut envoyer des données dans votre workspace. Gardez-la sur vos serveurs, jamais dans le code de votre site ou de votre app.
  1. Dans la barre latérale du workspace, cliquez sur Paramètres, puis, sous Données et déploiement, cliquez sur Screeb API.
  2. Sous Clé API du workspace, cliquez sur Copier.
  3. Transmettez la clé au développeur qui met en place l’intégration, par un canal sûr comme votre gestionnaire de mots de passe.
La page de réglages Screeb API, avec la clé API du workspace et son bouton Copier

La clé n’est pas l’identifiant de workspace présent dans le code d’installation de votre site ou de votre app. Cet identifiant est public et sert seulement au tag et aux SDK à reconnaître le workspace, voir Installer Screeb sur votre site ou votre application web.

Vos développeurs l’envoient dans l’en-tête Authorization: Bearer de chaque requête à l’API Screeb. Elle leur permet de :

Les endpoints, les formats et les limites sont décrits dans la référence de l’API Screeb.

Certaines intégrations affichent leur propre token sur leur page. Ce token est distinct de la clé API du workspace.

Réinitialisez la clé si elle a fuité, ou quand une personne qui la connaissait quitte votre équipe.

  1. Ouvrez Releases et cliquez sur Créer des Releases via l'API. La fenêtre affiche la même clé, avec un bouton de copie pour les Editors et Admins du workspace.
  2. Cliquez sur Réinitialiser, puis sur Réinitialiser le jeton. La nouvelle clé remplace l’ancienne immédiatement. Seuls les Admins de l’organisation voient Réinitialiser.
  3. Transmettez la nouvelle clé à vos développeurs, et mettez à jour chaque serveur, script et pipeline qui utilisait l’ancienne.

La réinitialisation est définitive. Tout appel qui utilise encore l’ancienne clé échoue avec une erreur d’autorisation jusqu’à ce qu’il reçoive la nouvelle, pour les données utilisateur comme pour les releases.

Votre backend peut envoyer des données et des releases à Screeb, et vous savez où changer la clé quand il le faut.

L’API répond 401 Unauthorized. La clé manque, est mal recopiée ou a été réinitialisée. Copiez-la de nouveau depuis Screeb API, et vérifiez que l’en-tête contient Authorization: Bearer suivi de la clé.

Les données arrivent dans le mauvais workspace. Chaque workspace a sa propre clé. Vérifiez que vous avez copié celle du workspace que vous consultez.