Een taaktool is waar de taken van een team al staan: Asana, ClickUp, HubSpot, Jira of Trello. Hier bedoelen we er een van, bereikt via een koppeling die je organisatie heeft gemaakt — een token dat een teamlid één keer heeft geplakt — in plaats van een kopie van je werk die ergens anders wordt bijgehouden.
Eén koppeling, twee ingangen
- Een projectkamer houdt zijn eigen taken gelijk met één project, lijst of pipeline: een taak die in de kamer wordt gemaakt verschijnt in de tool, en een wijziging in de tool komt terug.
- De API bereikt dezelfde koppeling rechtstreeks: Asana op /asana/v1, ClickUp op /clickup/v1, HubSpot op /hubspot/v1 en Jira op /jira/v1, elk met zeven bewerkingen, op dezelfde sleutel als de LinkedIn API.
De vier zijn één API, vier keer. Wat verschilt is het woord dat elke tool gebruikt voor de plek waar taken staan — Asana en Jira zeggen project, ClickUp zegt lijst, HubSpot zegt pipeline — en alle vier noemen het project_id. Een taak heeft altijd dezelfde vijf velden, uit welke tool hij ook komt: title, notes, status (open, doing of done), assignee en due.
Trello kan een kamer koppelen, maar heeft hier geen eigen API. Alles wat een kamer met Trello doet, gaat via dezelfde synchronisatie; het is de ingang die ontbreekt, niet de tool.
Veelgestelde vragen
Waar gaat het token heen?
Naar de projectkamerpagina, ingelogd, onder de taaktools van de kamer. Het gaat nooit via de API: POST /asana/v1/connections/link en de andere drie antwoorden met 403 en het adres van die pagina, omdat een geheim niet thuishoort in een API-aanroep die een assistent vasthoudt.
Kan ik bij de koppeling van iemand anders?
Nee. Een koppeling hoort bij één organisatie, en een koppeling van een ander wordt beantwoord precies zoals een die niet bestaat — 404, nooit 403, en in beide gevallen met dezelfde woorden, zodat een id niet kan worden afgetast. Een project-id wordt bij elke aanroep in de tool opgezocht in plaats van vertrouwd.
Wiens naam staat er bij het werk?
Die van het teamlid van wie het token de koppeling is. Een taak die via de API wordt gemaakt, maakt dat teamlid in de tool, alsof die persoon hem daar zelf had getypt.