Authentifizierung

Die Todomino-REST-API liegt unter https://app.todomino.eu/api und nutzt persönliche Zugriffstokens (PATs) für programmatischen Zugriff – Integrationen, Skripte und Automatisierungen.

Token erstellen

1. Öffne Einstellungen → Allgemein → API-Tokens in Todomino.
2. Benenne das Token nach der Integration, für die es gedacht ist (z. B. home-automation), damit du es später gezielt widerrufen kannst.
3. Kopiere das Token sofort – es beginnt mit tdm_ und wird nur einmal angezeigt.

Token verwenden

Sende das Token als Bearer-Token mit jeder Anfrage:

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

Tokens haben dieselben Berechtigungen wie dein Konto: jeder Arbeitsbereich, in dem du Mitglied bist, mit deiner jeweiligen Rolle.

Gut zu wissen

• Widerruf: Lösche ein Token jederzeit in den Einstellungen; es funktioniert sofort nicht mehr.
• Ein Token pro Integration – so betrifft ein Leck oder Widerruf nie alles auf einmal.
• Häufige Fehlerantworten: 401 (Token fehlt oder ist ungültig), 403 (gültiges Konto, aber unzureichende Rolle), 404 (auch für Arbeitsbereiche, in denen du kein Mitglied bist), 409 (Konflikt, z. B. gleichzeitige Bearbeitung), 413 (Speicherlimit des Arbeitsbereichs erreicht).