Ein Aufgaben-Tool ist der Ort, an dem die Aufgaben eines Teams ohnehin liegen: Asana, ClickUp, HubSpot, Jira oder Trello. Gemeint ist hier eines davon, erreicht über eine Verbindung, die Ihre Organisation hergestellt hat — ein Token, das ein Mitglied einmal eingefügt hat —, und keine Kopie Ihrer Arbeit an einem anderen Ort.
Eine Verbindung, zwei Zugänge
- Ein Projektraum hält seine eigenen Aufgaben im Gleichklang mit einem Projekt, einer Liste oder einer Pipeline: Eine im Raum angelegte Aufgabe erscheint im Tool, und eine im Tool vorgenommene Änderung kommt zurück.
- Die API erreicht dieselbe Verbindung direkt: Asana unter /asana/v1, ClickUp unter /clickup/v1, HubSpot unter /hubspot/v1 und Jira unter /jira/v1, mit je sieben Operationen und demselben Schlüssel wie die LinkedIn API.
Die vier sind eine API, viermal. Unterschiedlich ist nur das Wort, das jedes Tool für den Ort verwendet, an dem Aufgaben liegen — Asana und Jira sagen Projekt, ClickUp sagt Liste, HubSpot sagt Pipeline —, und alle vier nennen ihn project_id. Eine Aufgabe besteht aus denselben fünf Feldern, aus welchem Tool sie auch kommt: title, notes, status (open, doing oder done), assignee und due.
Trello kann ein Raum verknüpfen, hat hier aber keine eigene API. Alles, was ein Raum mit Trello tut, läuft über dieselbe Synchronisierung; es fehlt der Zugang, nicht das Tool.
Häufige Fragen
Wohin gehört das Token?
Auf die Projektraum-Seite, angemeldet, unter die Aufgaben-Werkzeuge des Raums. Es geht nie durch die API: POST /asana/v1/connections/link und die drei anderen antworten mit 403 und der Adresse dieser Seite, denn ein Geheimnis gehört nicht in einen API-Aufruf, den ein Assistent in der Hand hält.
Kann ich die Verbindung eines anderen erreichen?
Nein. Eine Verbindung gehört einer Organisation, und eine, die einer anderen gehört, wird genauso beantwortet wie eine, die es nicht gibt — 404, nie 403, und in beiden Fällen mit denselben Worten, damit sich IDs nicht abtasten lassen. Eine Projekt-ID wird bei jedem Aufruf im Tool nachgeschlagen, statt ihr zu vertrauen.
Wessen Name steht an der Arbeit?
Der des Mitglieds, dessen Token die Verbindung ist. Eine Aufgabe, die über die API angelegt wird, legt dieses Mitglied im Tool an, genau so, als hätte es sie dort selbst getippt.