Ricerca

Crea la tua app con l'API ClickUp

Vuoi creare un'app da integrare in ClickUp? Permetti ai tuoi utenti di accedere utilizzando OAuth 2.0. 
Assicurati inoltre di dare un'occhiata alla nostra documentazione API.

Cosa ti serve

Flusso OAuth 2

Quando vuoi sviluppare un'applicazione utilizzabile da altri, devi usare un flusso di autenticazione OAuth2.
Con OAuth 2, a tutti coloro che usano la tua app viene assegnato un token individuale. Ogni utente può accedere solo ai contenuti disponibili nel proprio account utente individuale di ClickUp.

Se non hai dimestichezza con OAuth2, Digital Ocean ha stilato una guida eccezionale (in inglese) che dovrebbe aiutarti a iniziare. Ti consigliamo anche di dare un'occhiata al sito web di OAuth per ulteriori dettagli.

Creare un'app

La prima cosa da fare per utilizzare OAuth 2 è creare un'app nella tua area di lavoro. Per gestire le impostazioni di integrazione devi essere titolare o amministratore di un'area di lavoro. A tale scopo:
  1. Nell'angolo in alto a destra, fai clic sul tuo avatar personale.
  2. Seleziona Impostazioni. 
  3. Nella barra laterale, fai clic su API ClickUp.
  4. Fai clic su + Crea un'app.
  5. Inserisci il nome della tua app e uno o più URL di reindirizzamento.
    Se non sai quale URL usare per il reindirizzamento, dai un'occhiata a questa guida sul sito web di OAuth.
  6. Fai clic su Crea app.
  7. Nella schermata successiva vedrai che sono stati generati un ID client un segreto client.
  8. Usa l'ID client e il Segreto client nella tua app per creare un flusso di autenticazione OAuth 2.

Screenshot della finestra modale dell'app che utilizza OAuth2.

Aggiornare gli URL di reindirizzamento

Se hai un nuovo URL di reindirizzamento, puoi aggiornare queste impostazioni nella tua area di lavoro di ClickUp in qualsiasi momento:
  1. Nell'angolo in alto a destra, fai clic sul tuo avatar personale.
  2. Seleziona Impostazioni. 
  3. Nella barra laterale, fai clic su API ClickUp.
  4. Fai clic su un'app esistente per espanderne i dettagli.
  5. Aggiorna l'URL di reindirizzamento.
  6. Fai clic su Salva.

Visualizza o rigenera il segreto client

Per rigenerare il segreto client:
  1. Nell'angolo in alto a destra, fai clic sul tuo avatar personale.
  2. Seleziona Impostazioni. 
  3. Nella barra laterale, fai clic su API ClickUp.
  4. Fai clic su un'app esistente per espanderne i dettagli.
  5. Fai clic su Mostra per visualizzare il segreto client attuale.
  6. Fai clic su Rigenera per creare un nuovo segreto client.
  7. Aggiorna l'app per usare il tuo nuovo segreto client.

Tipi di token di autorizzazione

I token ti permettono di effettuare chiamate API e di eseguire integrazioni con altre app. Puoi anche utilizzare applicazioni come Make per creare integrazioni senza scrivere codice. I token sono specifici per ciascun account utente di ClickUp:
chiunque abbia un account ClickUp può generare un token personale. Con i token personali è possibile concedere l'accesso a qualsiasi area di lavoro che il tuo account ha creato o a cui partecipa. Il tuo token personale ti offre lo stesso livello di accesso di un browser web.
Se utilizzi OAuth2, puoi scegliere di autorizzare l'accesso ad aree di lavoro specifiche alla prima autenticazione o alle riautenticazioni successive.
Screenshot della selezione dell'area di lavoro da autorizzare con OAuth2.

Questo articolo ti è stato utile?