ZEITLICHT
Retour à l’aperçu

API et intégrations

Lire le journal d'accès d'une clé API

Je veux …

… voir à quoi une clé a servi, depuis où, et si cela a marché.

Avant de commencer

  • Seuls Propriétaire et Admin voient les clés API et leurs journaux d'accès, pour toutes les clés de l'espace de travail.
  • Le journal garde les requêtes 90 jours, puis les supprime.
  • Il liste les requêtes faites avec la bonne clé, même refusées, par exemple après la révocation de la clé. Les tentatives avec une mauvaise clé n'y figurent pas.

Voici comment

  1. Ouvrez Réglages dans l'espace de travail, puis Clés API.
  2. Touchez une clé. Sa page s'ouvre, avec le nom de la clé comme titre.
  3. En haut, vous voyez le début de la clé, Créée par … et son statut, par exemple Active, Expire dans 5 jours, Inactive, Expirée ou Révoquée, avec la raison s'il y en a une.
  4. En dessous figurent les dates : Créée le …, Utilisée pour la dernière fois le … ou Pas encore utilisée, puis Expire le …, Expirée le … ou Révoquée le ….
  5. Autorisations montre le niveau et chaque autorisation. Tableaux liste les tableaux que la clé peut voir. Un tableau qui n'existe plus apparaît comme Tableau supprimé.
  6. Journal d'accès liste les requêtes, les plus récentes d'abord. Chaque ligne montre la requête, par exemple GET /tasks/3f2a9c1e ou MCP tools/call get_task 3f2a9c1e, et une pastille avec le code de statut de la réponse. Une requête refusée montre aussi sa raison, par exemple key-revoked.
  7. La ligne en dessous donne la date et l'heure, l'adresse IP et le programme qui a envoyé la requête.
  8. Touchez Charger plus en bas de la liste pour les requêtes plus anciennes. Si le chargement échoue, touchez Réessayer.
  9. Si une requête vous paraît suspecte, touchez Révoquer la clé et confirmez avec Révoquer. La page reste ouverte et affiche la clé comme Révoquée.

Le résultat

Vous savez quel programme a utilisé la clé, quand, depuis quelle adresse et avec quel résultat.

Questions fréquentes

Que signifient les codes de statut ?

200 et 201 ont marché. 401 signifie que la clé a été refusée : elle est fausse, expirée ou révoquée, ou la personne qui l'a créée n'est plus admin. 403 signifie que la clé n'a pas le droit de faire cela : une autorisation manque, la personne qui l'a créée n'a pas Ultra, l'espace de travail n'a pas accès à l'API, ou la requête demande une clé pour tous les tableaux, par exemple pour créer un tag ou un sujet (all-boards-required). 404 signifie que la tâche ou le tableau n'existe pas, ou n'est pas sur les tableaux de la clé. 409 signifie qu'un ID court correspond à plusieurs tâches, ou qu'une requête avec la même Idempotency-Key est encore en cours. 422 signifie qu'une Idempotency-Key a été réutilisée pour une autre requête. 429 signifie trop de requêtes en peu de temps ; le programme doit attendre et réessayer. Si un programme reçoit 429 en continu, le journal l'affiche environ une fois par minute et par clé, pas à chaque requête refusée.

J'ai désactivé un compte ou une formule a pris fin, mais la clé marchait encore.

Les changements sur le compte de la personne qui a créé la clé, comme un compte désactivé ou la perte d'Ultra, peuvent mettre jusqu'à 30 secondes à arrêter la clé. Si cette personne n'est plus admin ou quitte l'espace de travail, la clé s'arrête aussitôt.

Que signifie MCP ?

La requête vient de Claude Code ou d'un autre outil d'IA connecté par MCP. Le nom après tools/call, par exemple get_task, est l'outil utilisé.

La clé est révoquée, mais des requêtes continuent d'arriver. Que faire ?

Un programme possède encore la clé. Chacune de ces requêtes est refusée avec 401 et key-revoked. Retrouvez le programme grâce à l'adresse IP et au nom dans le journal, et retirez-y la clé.

Pourquoi la liste est-elle vide ?

La clé n'a pas servi ces 90 derniers jours. La page affiche Aucune requête pour l'instant..

Sujets liés