Aller au contenu principal

REST API

L'API REST de TodoMate vous permet de gérer vos tâches, objectifs et vision depuis n'importe quel client HTTP. Ce guide vous explique comment obtenir un token et effectuer votre première requête avec curl.

Prérequis​

  • Un compte sur todo.ac (connexion avec GitHub)
  • Un abonnement Pro — requis pour générer une clé API

Étape 1 — Installer le CLI GitHub​

La façon la plus simple d'obtenir un token d'accès GitHub est d'utiliser le CLI GitHub.

# macOS
brew install gh

# Windows
winget install GitHub.cli

# Linux — voir https://github.com/cli/cli/blob/trunk/docs/install_linux.md

Étape 2 — Obtenir un token d'accès GitHub​

gh auth login
gh auth token

Copiez le token affiché — vous en aurez besoin à l'étape 4.

Étape 3 — Obtenir votre clé API​

Votre clé API authentifie votre client auprès de l'API.

  1. Ouvrez todo.ac
  2. Allez dans Compte → Clés API
  3. Appuyez sur Générer une clé, donnez-lui un nom et copiez la valeur — elle n'est affichée qu'une seule fois

Étape 4 — Obtenir un JWT TodoMate​

Échangez votre token GitHub contre un JWT de courte durée :

JWT=$(curl -s -X POST https://api.todo.ac/v1/auth/token \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: VOTRE_CLE_API" \
  -d '{"github_token": "VOTRE_TOKEN_GITHUB"}' \
  | jq -r '.access_token')

echo $JWT

Remarque : jq est utilisé ici pour analyser la réponse JSON. Installez-le avec brew install jq ou votre gestionnaire de paquets.

Étape 5 — Lister vos tâches​

curl https://api.todo.ac/v1/todos \
  -H "Authorization: Bearer $JWT" \
  -H "Ocp-Apim-Subscription-Key: VOTRE_CLE_API"

Vous devriez recevoir un tableau JSON contenant vos tâches.

Étapes suivantes​

Parcourez la Référence API complète pour explorer tous les endpoints disponibles — tâches, objectifs, vision et plus encore.