Clés d'API

Les clés sont destinées à l'intégration continue (CI) et aux clients qui ne peuvent pas se connecter via un navigateur. Comment en créer une, comment elle est stockée et comment la révoquer.

Vous n'avez pas besoin d'une clé pour Claude, Cursor, Lovable ou ChatGPT : ils se connectent via le navigateur. Les clés sont pour les scripts, les travaux CI et les clients sans navigateur.

En créer une

Ouvrez « Agents & API » (Agents et API), tapez une étiquette (par exemple « Déploiement CI ») et appuyez sur « Create key » (Créer une clé). La clé s'affiche une seule fois, alors copiez-la maintenant. Elle ressemble à sbe_ak_<id>_<secret>. TileSet ne stocke qu'un hachage du secret, il ne peut donc pas la réafficher. Perdez-la et vous en créez une nouvelle.

Utilisez-la

Envoyez-la sous forme de Authorization: Bearer <key> dans les requêtes à l'API REST ou au serveur MCP. La gestion des clés, l'exportation de vos données et la suppression du compte nécessitent une connexion au tableau de bord, pas une clé. Gardez-la hors du code source et hors de toute page : le widget sur votre page n'a jamais besoin de clé.

Ce qu'une clé peut lire

Une clé configure et exécute des widgets. Elle ne lit jamais votre contenu : pour une source, elle obtient des comptages, tels que le nombre d'éléments qu'elle contient, leurs notes d'étoiles et combien ont des photos, jamais les publications ou les avis eux-mêmes. Si une source échoue, une clé reçoit une phrase fixe, pas la réponse de la plateforme elle-même. Pour voir un widget, ouvrez https://app.tileset.com/preview/<widgetId> : le widget tel que les visiteurs le voient.

Révoquez-la

La liste sur « Agents & API » affiche l'étiquette de chaque clé, une forme masquée et quand elle a été créée. « Revoke » (Révoquer) est un bouton en deux étapes et prend effet immédiatement. Les agents connectés via l'authentification du navigateur obtiennent également une clé, nommée d'après l'application (avec « OAuth ») ; la révoquer déconnecte cet agent.

Limites

• Jusqu'à 20 clés actives par compte, en comptant les clés des agents connectés via le navigateur. Révoke une pour en ajouter une autre.
• Les clés que vous créez n'expirent pas ; la révocation est la façon dont elles se terminent. Un agent connecté via le navigateur est déconnecté après 90 jours d'inactivité et vous demande de le réapprouver la prochaine fois que vous l'utilisez.
• Une clé divulguée peut accéder à vos widgets et sources, jamais à vos jetons de plateforme. Révoke-la et créez-en une nouvelle.