Uno strumento di gestione del lavoro è il posto in cui le attività di un team già vivono: Asana, ClickUp, HubSpot, Jira o Trello. Qui indica uno di questi raggiunto tramite una connessione fatta dalla vostra organizzazione — un token che un membro ha incollato una sola volta — e non una copia del vostro lavoro tenuta altrove.
Una connessione, due vie d'accesso
- Una stanza di progetto tiene le proprie attività allineate a un progetto, una lista o una pipeline: un'attività creata nella stanza compare nello strumento, e una modifica fatta nello strumento torna nella stanza.
- L'API raggiunge direttamente la stessa connessione: Asana su /asana/v1, ClickUp su /clickup/v1, HubSpot su /hubspot/v1 e Jira su /jira/v1, sette operazioni ciascuno, con la stessa chiave della LinkedIn API.
I quattro sono un'unica API ripetuta quattro volte. Cambia la parola che ogni strumento usa per il posto in cui stanno le attività — Asana e Jira lo chiamano progetto, ClickUp lista, HubSpot pipeline — e tutti e quattro lo chiamano project_id. Un'attività ha gli stessi cinque campi qualunque sia lo strumento da cui arriva: title, notes, status (open, doing o done), assignee e due.
Trello si collega solo da una stanza e qui non ha un'API propria. Tutto ciò che una stanza fa con Trello lo fa attraverso lo stesso motore di sincronizzazione; a mancare è la porta d'ingresso, non lo strumento.
Domande frequenti
Dove va il token?
Nella pagina delle stanze, dopo aver effettuato l'accesso, negli strumenti per le attività della stanza. Non passa mai dall'API: POST /asana/v1/connections/link e gli altri tre rispondono 403 con l'indirizzo di quella pagina, perché un segreto non ha posto in una chiamata API che un assistente tiene in mano.
Posso raggiungere la connessione di un'altra organizzazione?
No. Una connessione appartiene a un'organizzazione, e quella di un'altra riceve esattamente la stessa risposta di una che non esiste — 404, mai 403, e con le stesse parole nei due casi, così che un id non possa essere sondato. L'id di un progetto viene cercato nello strumento a ogni chiamata invece di essere dato per buono.
A nome di chi è il lavoro?
Del membro il cui token è la connessione. Un'attività creata tramite l'API è creata da quella persona nello strumento, come se l'avesse scritta lì.