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.
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é.
Avant de commencer
Section intitulée « Avant de commencer »- 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.
Copier la clé
Section intitulée « Copier la clé »- Dans la barre latérale du workspace, cliquez sur Paramètres, puis, sous Données et déploiement, cliquez sur Screeb API.
- Sous Clé API du workspace, cliquez sur Copier.
- 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 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.
Utiliser la clé
Section intitulée « Utiliser la clé »Vos développeurs l’envoient dans l’en-tête Authorization: Bearer de chaque requête à l’API Screeb. Elle leur permet de :
- Envoyer des données utilisateur depuis votre backend : propriétés, événements, groupes, pages et écrans vus. Voir Envoyer et gérer les propriétés utilisateur et Suivre et gérer les événements utilisateur.
- Enregistrer des releases depuis votre pipeline de déploiement, voir Suivre vos releases.
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éinitialiser la clé
Section intitulée « Réinitialiser la clé »Réinitialisez la clé si elle a fuité, ou quand une personne qui la connaissait quitte votre équipe.
- 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.
- 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.
- 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.
Ce que vous obtenez
Section intitulée « Ce que vous obtenez »Votre backend peut envoyer des données et des releases à Screeb, et vous savez où changer la clé quand il le faut.
Dépannage
Section intitulée « Dépannage »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.