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.
Tworzenie tokenu
Dział zatytułowany „Tworzenie tokenu”- Otwórz Ustawienia → Ogólne → Tokeny API w Todomino.
- Nazwij token od integracji, dla której jest przeznaczony (np.
home-automation), aby móc go później niezależnie unieważnić. - Skopiuj token od razu — zaczyna się od
tdm_i jest pokazywany tylko raz.
Używanie tokenu
Dział zatytułowany „Używanie tokenu”Wysyłaj token jako bearer token w każdym żądaniu:
curl -H "Authorization: Bearer tdm_..." \ https://app.todomino.eu/api/workspacesTokeny mają te same uprawnienia co Twoje konto: każdy obszar roboczy, którego jesteś członkiem, z Twoją rolą w każdym z nich.
Warto wiedzieć
Dział zatytułowany „Warto wiedzieć”- 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).
