Vai al contenuto principale

REST API

La REST API di TodoMate ti consente di gestire le tue attività, obiettivi e visione da qualsiasi client HTTP. Questa guida spiega come ottenere un token ed effettuare la prima richiesta con curl.

Prerequisiti​

  • Un account su todo.ac (accesso con GitHub)
  • Un abbonamento Pro — necessario per generare una chiave API

Passaggio 1 — Installa il GitHub CLI​

Il modo più semplice per ottenere un token di accesso GitHub è usare il GitHub CLI.

# macOS
brew install gh

# Windows
winget install GitHub.cli

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

Passaggio 2 — Ottieni un token di accesso GitHub​

gh auth login
gh auth token

Copia il token mostrato — ti servirà al Passaggio 4.

Passaggio 3 — Ottieni la tua chiave API​

La chiave API autentica il tuo client con l'API.

  1. Apri todo.ac
  2. Vai su Account → Chiavi API
  3. Tocca Genera chiave, assegnale un nome e copia il valore — viene mostrato una sola volta

Passaggio 4 — Ottieni un JWT di TodoMate​

Scambia il tuo token GitHub per un JWT di breve durata:

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

echo $JWT

Nota: jq viene usato per analizzare la risposta JSON. Installalo con brew install jq o il tuo gestore di pacchetti.

Passaggio 5 — Elenca le tue attività​

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

Dovresti ricevere un array JSON con le tue attività.

Prossimi passi​

Esplora la Riferimento API completo per scoprire tutti gli endpoint disponibili — attività, obiettivi, visione e altro ancora.