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.
Suggerimento: 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. Apri le tue impostazioni personali:
    • ClickUp 2.0: fai clic sul tuo avatar nell'angolo in basso a sinistra. Seleziona le mie impostazioni.
    • ClickUp 3.0: fai clic sul tuo avatar nell'angolo in alto a destra. Seleziona le mie impostazioni
  2. Nella barra laterale, fai clic su API ClickUp.
  3. Fai clic su + Crea un'app.
  4. Inserisci il nome della tua app e uno o più URL di reindirizzamento.
    • Suggerimento: se non sai quale URL usare per il reindirizzamento, dai un'occhiata a questa guida sul sito web di OAuth.
  5. Fai clic su Crea app.
  6. Nella schermata successiva vedrai che sono stati generati un ID client un segreto client.
  7. 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

Hai un nuovo URL di reindirizzamento? Puoi aggiornare queste impostazioni nella tua area di lavoro di ClickUp in qualsiasi momento.
  1. Fai clic sull'avatar della tua area di lavoro.
  2. Seleziona Integrazioni.
  3. Fai clic sull'API ClickUp.
  4. Espandi l'app per visualizzarne i dettagli.
  5. Aggiorna la tua app:
    • Aggiungi o aggiorna gli URL di reindirizzamento.
    • Fai clic su Salva.

Visualizza o rigenera il segreto client

Vuoi rigenerare il segreto client? Puoi farlo in qualsiasi momento.
  1. Fai clic sull'avatar della tua area di lavoro.
  2. Seleziona Integrazioni.
  3. Fai clic sull'API ClickUp.
  4. Espandi l'app per visualizzarne i dettagli.
  5. Fai clic su Mostra per vedere il segreto client attuale.
  6. Fai clic su Rigenera per creare immediatamente un nuovo segreto client.
  7. Aggiorna la tua app per utilizzare 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.

Aggiornato

Questo articolo ti è stato utile?