Vuoi creare un'app che si integri con ClickUp? Dai ai tuoi utenti la possibilità di accedere tramite OAuth 2.0!
Consulta anche la nostra documentazione API!
Cosa ti serve
- L'API di ClickUp è disponibile su tutti i piani ClickUp.
- I titolari o gli amministratori dell'area di lavoro possono gestire le impostazioni di integrazione e creare app OAuth nell'area di lavoro.
- I membri e i membri con accesso limitato con autorizzazioni di modifica complete possono usare i token API personali.
- I membri con accesso limitato e autorizzazioni di sola visualizzazione non possono accedere all'API né gestirla.
Flusso OAuth 2
Se vuoi sviluppare un'applicazione che altri possono usare, devi adottare un flusso di autenticazione OAuth2.
Con OAuth 2, a ogni utente che usa la tua app viene assegnato un token personalizzato. Ogni utente può accedere solo ai contenuti disponibili nel proprio account utente ClickUp.
Se non conosci OAuth2, Digital Ocean ha preparato un'ottima guida per iniziare. Ti consigliamo inoltre di consultare il sito di OAuth per ulteriori dettagli.
Crea un'app
Il primo passo per usare OAuth 2 è creare un'app nella tua area di lavoro. Per gestire le impostazioni di integrazione devi essere titolare o amministratore dell'area di lavoro.
Per creare un'app nella tua area di lavoro:
- Nell'angolo in alto a sinistra, fai clic sull'avatar della tua area di lavoro.
- Seleziona Impostazioni.
- Nella barra laterale Tutte le impostazioni, seleziona API ClickUp.
- Nell'angolo in alto a destra della pagina Impostazioni API ClickUp, fai clic su Crea un'app.
- Inserisci il nome della tua app e uno o più URL di reindirizzamento. Se non sai quale URL di reindirizzamento usare, consulta la guida agli URL di reindirizzamento sul sito di OAuth.
- Fai clic su Crea app.
- Nella schermata successiva vedrai che sono stati generati un ID client e un segreto client.
- Usa l'ID client e il segreto client nella tua app per creare un flusso di autenticazione OAuth 2.
Aggiorna i tuoi URL di reindirizzamento
Se hai un nuovo URL di reindirizzamento, puoi aggiornare queste impostazioni nella tua area di lavoro ClickUp in qualsiasi momento:
- Nell'angolo in alto a sinistra, fai clic sull'avatar della tua area di lavoro.
- Seleziona Impostazioni.
- Nella barra laterale Tutte le impostazioni, seleziona API ClickUp.
- Fai clic su un'app esistente per espanderne i dettagli.
- Aggiorna l'URL di reindirizzamento.
- Fai clic su Salva.
Visualizza o rigenera il tuo segreto client
Per rigenerare il tuo segreto client:
- Nell'angolo in alto a sinistra, fai clic sull'avatar della tua area di lavoro.
- Seleziona Impostazioni.
- Nella barra laterale Tutte le impostazioni, seleziona API ClickUp.
- Fai clic su un'app esistente per espanderne i dettagli.
- Fai clic su Mostra per visualizzare il tuo segreto client attuale.
- Fai clic su Rigenera per creare un nuovo segreto client.
- Aggiorna la tua app per usare il nuovo segreto client.
Tipi di token di autorizzazione
I token ti permettono di effettuare chiamate API e di integrarti con altre applicazioni. Puoi anche usare app come Make per creare integrazioni senza scrivere codice. I token sono specifici del tuo account utente ClickUp.
Chiunque abbia un account ClickUp può generare un token personale. I token personali consentono l'accesso a tutte le aree di lavoro che il tuo account ha creato o a cui si è unito. Il tuo token personale ti garantisce lo stesso accesso che hai tramite browser web.
Se usi OAuth2, puoi scegliere di autorizzare l'accesso a specifiche aree di lavoro al momento della prima autenticazione o quando ti autentichi nuovamente in un secondo momento.