Autenticazione

L’API REST di Todomino vive su https://app.todomino.eu/api e usa token di accesso personali (PAT) per l’accesso programmatico — integrazioni, script e automazioni.

Creare un token

1. Apri Impostazioni → Generale → Token API in Todomino.
2. Dai al token il nome dell’integrazione a cui è destinato (per esempio home-automation), così potrai revocarlo in modo indipendente.
3. Copia subito il token — inizia con tdm_ e viene mostrato una sola volta.

Usare il token

Invia il token come bearer token in ogni richiesta:

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

I token hanno gli stessi permessi del tuo account: ogni spazio di lavoro di cui sei membro, con il tuo ruolo in ciascuno.

Buono a sapersi

• Revoca: elimina un token nelle impostazioni in qualsiasi momento; smette di funzionare immediatamente.
• Un token per integrazione: così una fuga o una revoca non tocca mai tutto il resto.
• Risposte di errore comuni: 401 (token mancante o non valido), 403 (account valido ma ruolo insufficiente), 404 (anche per spazi di cui non sei membro), 409 (conflitto, per esempio modifica simultanea), 413 (limite di archiviazione dello spazio raggiunto).