API
Klucze API do własnych zadań — dla automatyzacji, integracji i skryptów.
Do zadań (moduł „Zadania") można podłączyć zewnętrzną automatyzację przez proste REST API zabezpieczone kluczem.
Tworzenie klucza
W Ustawieniach, w sekcji „Klucze API", nadaj kluczowi nazwę i opcjonalnie wybierz kategorię — klucz zawężony do kategorii widzi tylko zadania w niej, bez zawężenia widzi wszystkie Twoje zadania. Surowa wartość klucza pokazuje się dokładnie raz, zaraz po utworzeniu — zapisz ją od razu, bo nie da się jej odzyskać (można za to utworzyć nowy klucz albo unieważnić stary w dowolnym momencie).
Uwierzytelnianie
Każde żądanie musi zawierać nagłówek:
Authorization: Bearer <twój-klucz>
Endpointy
Wszystkie ścieżki zaczynają się od https://ordiarion.com/api/public/tasks.
Statusy zadań to TODO albo DONE. Świadomie brak tworzenia i usuwania
zadań przez API — te dwie akcje zostają w interfejsie, klucz służy do
sprawdzania i aktualizowania tego, co już istnieje.
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | / |
Lista zadań (parametr status opcjonalny) |
| GET | /{id} |
Jedno zadanie |
| PATCH | /{id}/status |
Zmiana statusu, body {"status":"DONE"} |
| GET | /{id}/comments |
Komentarze do zadania |
| POST | /{id}/comments |
Nowy komentarz, body {"body":"…"} |
Zadanie spoza zasięgu klucza (cudze albo z innej kategorii niż ta, do której
klucz jest zawężony) zwraca 404, tak samo jak zadanie, które nie istnieje.
Przykład
curl -H "Authorization: Bearer <twój-klucz>" \
https://ordiarion.com/api/public/tasks?status=TODO
Unieważnienie
W Ustawieniach, przy kluczu, przycisk „Unieważnij" — działa natychmiast i nieodwracalnie. Każda automatyzacja korzystająca z tego klucza przestaje mieć dostęp od razu.