Crea tu propia aplicación con la API de ClickUp

¿Quieres crear una aplicación que se integre con ClickUp? Ofrece a tus usuarios la posibilidad de iniciar sesión con OAuth 2.0. 
Y asegúrate también de revisar nuestra documentación sobre la API.

Qué necesitas

Flujo OAuth2

Si quieres desarrollar una aplicación que puedan usar otras personas, es imprescindible que incluyas un flujo de autenticación OAuth2.
OAuth2 asigna un token individual a todas las personas que usen tu aplicación. Los usuarios solo pueden acceder al contenido que está disponible para su cuenta de ClickUp.

Si no te defiendes con OAuth2, Digital Ocean ha elaborado una fantástica guía para ayudarte con los primeros pasos. También te recomendamos que consultes el sitio web de OAuth para obtener más información.

Crear una aplicación

El primer paso para usar OAuth2 es crear una aplicación en tu entorno de trabajo. Debes ser el propietario o administrador del entorno de trabajo para poder gestionar los ajustes de la integración. Haz lo siguiente:
  1. Haz clic en tu avatar personal, situado en la esquina superior derecha.
  2. Selecciona Ajustes
  3. En la barra lateral, haz clic en API de ClickUp.
  4. Haz clic en + Crear una aplicación.
  5. Escribe el nombre de la aplicación y una URL de redireccionamiento.
    Si no sabes qué URL utilizar, echa un vistazo a esta guía en el sitio web de OAuth.
  6. Haz clic en Crear aplicación.
  7. En la pantalla siguiente, verás que se han generado un ID de cliente y un secreto del cliente.
  8. Usa el ID de cliente y el secreto del cliente de tu aplicación para crear un flujo de autenticación OAuth2.

Captura de pantalla del cuadro de diálogo modal de la aplicación usando OAuth2.

Actualiza tu URL de redireccionamiento

Si tienes una URL de redireccionamiento nueva, puedes modificar estos ajustes en tu entorno de trabajo de ClickUp cuando quieras. Sigue estos pasos:
  1. Haz clic en tu avatar personal, situado en la esquina superior derecha.
  2. Selecciona Ajustes
  3. En la barra lateral, haz clic en API de ClickUp.
  4. Haz clic en una aplicación existente para ver todos los detalles.
  5. Modifica la URL de redireccionamiento.
  6. Haz clic en Guardar.

Consulta o vuelve a generar tu secreto del cliente

Sigue estos pasos para volver a generar tu secreto del cliente:
  1. Haz clic en tu avatar personal, situado en la esquina superior derecha.
  2. Selecciona Ajustes
  3. En la barra lateral, haz clic en API de ClickUp.
  4. Haz clic en una aplicación existente para ver todos los detalles.
  5. Haz clic en Mostrar para ver el secreto del cliente actual.
  6. Haz clic en Volver a generar para crear un secreto del cliente nuevo.
  7. Actualiza tu aplicación para usar el nuevo secreto del cliente.

Tipos de token de autorización

Los tokens te permiten hacer llamadas a API e integrar ClickUp con otras aplicaciones. También puedes usar apps como Make para crear integraciones sin escribir código. Los tokens son específicos de tu cuente de ClickUp.
Cualquier persona que tenga una cuenta de ClickUp puede generar un token personal. Los tokens personales dan acceso a todos los entornos de trabajo creados en tu cuenta o a los que te hayas unido. Con un token personal, tienes el mismo acceso que en navegador web.
Si usas OAuth2, puedes elegir entre autorizar el acceso a entornos de trabajo específicos la primera vez que te autenticas o cuando vuelvas a autenticarte más adelante.
Captura de pantalla de una persona seleccionando los entornos de trabajo que va a autorizar con OAuth2.

¿Fue útil este artículo?