Narzędzie do zadań to miejsce, w którym zadania zespołu już się znajdują: Asana, ClickUp, HubSpot, Jira albo Trello. Chodzi tu o jedno z nich, osiągane przez połączenie, które utworzyła twoja organizacja — token wklejony raz przez członka zespołu — a nie o kopię twojej pracy trzymaną gdzie indziej.
Jedno połączenie, dwa wejścia
- Pokój projektowy utrzymuje własne zadania w zgodzie z jednym projektem, listą lub pipeline: zadanie utworzone w pokoju pojawia się w narzędziu, a zmiana zrobiona w narzędziu wraca.
- API sięga do tego samego połączenia bezpośrednio: Asana pod /asana/v1, ClickUp pod /clickup/v1, HubSpot pod /hubspot/v1 i Jira pod /jira/v1, po siedem operacji każde, na tym samym kluczu co LinkedIn API.
Te cztery to jedno API, cztery razy. Różni się tylko słowo, którego każde narzędzie używa na miejsce, gdzie leżą zadania — Asana i Jira mówią projekt, ClickUp mówi lista, HubSpot mówi pipeline — a wszystkie cztery nazywają je project_id. Zadanie to zawsze te same pięć pól, bez względu na to, z jakiego narzędzia pochodzi: title, notes, status (open, doing albo done), assignee i due.
Trello może połączyć pokój, ale nie ma tu własnego API. Wszystko, co pokój robi z Trello, przechodzi przez ten sam silnik synchronizacji; brakuje wejścia, a nie narzędzia.
O co ludzie pytają
Gdzie trafia token?
Na stronie pokoi projektowych, po zalogowaniu, w narzędziach do zadań pokoju. Nigdy nie idzie przez API: POST /asana/v1/connections/link i pozostałe trzy odpowiadają 403 i adresem tej strony, bo sekret nie należy do wywołania API, które trzyma asystent.
Czy mogę sięgnąć do cudzego połączenia?
Nie. Połączenie należy do jednej organizacji, a to, które należy do innej, dostaje taką samą odpowiedź jak nieistniejące — 404, nigdy 403, i w obu wypadkach tymi samymi słowami, żeby identyfikatorów nie dało się sondować. Identyfikator projektu jest przy każdym wywołaniu sprawdzany w narzędziu, a nie przyjmowany na wiarę.
Czyje nazwisko stoi przy pracy?
Członka zespołu, którego tokenem jest połączenie. Zadanie utworzone przez API tworzy w narzędziu ta osoba, tak jakby wpisała je tam sama.