Przejdź do głównej zawartości

Uwierzytelnianie

REST API Todomino znajduje się pod https://app.todomino.eu/api i używa osobistych tokenów dostępu (PAT) do dostępu programistycznego — integracje, skrypty i automatyzacje.

  1. Otwórz Ustawienia → Ogólne → Tokeny API w Todomino.
  2. Nazwij token od integracji, dla której jest przeznaczony (np. home-automation), aby móc go później niezależnie unieważnić.
  3. Skopiuj token od razu — zaczyna się od tdm_ i jest pokazywany tylko raz.

Wysyłaj token jako bearer token w każdym żądaniu:

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

Tokeny mają te same uprawnienia co Twoje konto: każdy obszar roboczy, którego jesteś członkiem, z Twoją rolą w każdym z nich.

  • Unieważnianie: usuń token w ustawieniach w dowolnym momencie; natychmiast przestaje działać.
  • Jeden token na integrację — wyciek lub unieważnienie nigdy nie dotyka całej reszty.
  • Typowe odpowiedzi błędów: 401 (brak lub nieprawidłowy token), 403 (prawidłowe konto, ale niewystarczająca rola), 404 (także dla obszarów, których nie jesteś członkiem), 409 (konflikt, np. równoczesna edycja), 413 (osiągnięto limit miejsca w obszarze).