Aller au contenu
Tickr

Tickr a-t-il une API publique ?

Réponse courte

Section intitulée « Réponse courte »

Oui — sous /api/v1/..., authentifiée par API key. La documentation est intégralement publiée sur /en/api/.

Détails

Section intitulée « Détails »

L’API publique couvre :

  • Entrées de temps : lecture, création, modification, suppression et import en lot (bulk upsert).
  • Timers : démarrer, arrêter, lister les timers en cours.
  • Projets, tâches, tags et clients : lecture seule.
  • Pagination par curseur (entrées, clients), erreurs RFC 7807, quota de requêtes par clé.

Pour vous lancer :

  1. Créez une clé API depuis Intégrations → Clés d’API → Créer une clé (pas-à-pas illustré : Clés API personnelles). Tout membre actif d’un workspace peut créer ses propres clés :

    • Rôle de la clé : au plus votre propre rôle, jamais Propriétaire. Pour le connecteur MCP, choisissez Membre (recommandé). Un Analyste ne peut créer que des clés Analyste (lecture seule), et un Membre ne peut pas créer de clé Analyste.
    • Expiration : 30 jours, 90 jours (par défaut), 1 an ou jamais.
    • Une seule fois : la clé n’est affichée qu’à sa création. Copiez-la immédiatement ; personne ne pourra la réafficher.
    • Limites : 10 clés actives par workspace et par personne ; 10 tentatives de création par heure (les demandes refusées comptent aussi).
    • Un email vous prévient à chaque création de clé sur votre compte (sans jamais contenir la clé), lorsque l’envoi d’emails est configuré.
    • Les Propriétaires et Administrateurs voient et peuvent révoquer toutes les clés de leur workspace ; les autres membres ne voient que les leurs.
    • Vos clés d’un workspace sont révoquées si vous le quittez, si vous en êtes retiré ou s’il est supprimé.
    • Après une réinitialisation de mot de passe via le lien reçu par email, toutes les sessions et toutes vos clés API, dans tous vos workspaces, cessent immédiatement de fonctionner : reconnectez-vous puis recréez vos clés. Changer votre mot de passe depuis votre Profil ne révoque rien.

  2. Testez avec curl :

    Fenêtre de terminal
    curl https://tickr.coderise.cloud/api/v1/projects \
      -H "Authorization: Bearer tkr_live_<random>"

  3. Consultez la référence des endpoints pour la liste complète.

Pour une intégration sur mesure (webhooks, SSO, multi-tenant), contactez le support — certaines fonctionnalités peuvent être priorisées sur demande.