Authentification

L’API REST de Todomino se trouve sur https://app.todomino.eu/api et utilise des jetons d’accès personnels (PAT) pour l’accès programmatique — intégrations, scripts et automatisations.

Créer un jeton

1. Ouvre Réglages → Général → Jetons d’API dans Todomino.
2. Nomme le jeton d’après l’intégration à laquelle il est destiné (par exemple home-automation), pour pouvoir le révoquer indépendamment.
3. Copie le jeton immédiatement — il commence par tdm_ et n’est affiché qu’une seule fois.

Utiliser le jeton

Envoie le jeton en bearer token avec chaque requête :

curl -H "Authorization: Bearer tdm_..." \
  https://app.todomino.eu/api/workspaces

Les jetons ont les mêmes permissions que ton compte : chaque espace de travail dont tu es membre, avec ton rôle dans chacun.

Bon à savoir

• Révocation : supprime un jeton à tout moment dans les réglages ; il cesse de fonctionner immédiatement.
• Un jeton par intégration : une fuite ou une révocation n’affecte jamais tout le reste.
• Réponses d’erreur courantes : 401 (jeton manquant ou invalide), 403 (compte valide mais rôle insuffisant), 404 (aussi pour les espaces dont tu n’es pas membre), 409 (conflit, p. ex. modification simultanée), 413 (limite de stockage de l’espace atteinte).