Crea tu propia aplicación con la API de ClickUp

Estamos traduciendo los artículos de nuestro Centro de ayuda. También puedes consultar el Centro de ayuda en inglés o contactarnos con tus comentarios.

¿Quieres crear una aplicación que se integre con ClickUp? ¡Dale a tus usuarios la capacidad de iniciar sesión usando OAuth 2.0! 
¡Asegúrate de revisar también nuestra documentación de API!

Lo que necesitarás

  • La API de ClickUp está disponible en todos los planes de ClickUp.
  • Un propietario o administrador del entorno de trabajo deberá crear una aplicación en tu entorno de trabajo de ClickUp.

Flujo OAuth 2

Cuando quieras desarrollar una aplicación que otros puedan usar, debes utilizar un flujo de código de autorización de OAuth 2.
Con OAuth 2, a todos los que usen tu aplicación se les asigna un token individualizado. Cada usuario solo puede acceder al contenido disponible en su cuenta de usuario individual de ClickUp.
Consejo: Si no estás familiarizado con OAuth 2, Digital Ocean ha creado una excelente guía que debería ayudarte a comenzar. También te recomendamos consultar el sitio web de OAuth para obtener detalles adicionales.

Crear una aplicación

El primer paso para usar OAuth 2 es crear una aplicación en tu entorno de trabajo.
Debes ser propietario o administrador del entorno de trabajo para administrar la configuración de integración. Para hacerlo:
    1. En la esquina inferior izquierda, haz clic en el avatar de tu entorno de trabajo.
    2. Selecciona Integraciones.
    3. Haz clic en ClickUp API.
      • Ingresa el nombre de tu aplicación y una(s) URL(s) de redireccionamiento.Consejo: ¿No estás seguro de qué usar para tu URL de redireccionamiento? Consulta esta guía en el sitio web de OAuth.
    4. Haz clic en Crear aplicación.
    5. En la siguiente pantalla, verás que se han generado un ID de cliente y un Secreto de cliente.
    6. Utiliza el ID de cliente y el Secreto de cliente en tu aplicación para crear un flujo de código de autorización OAuth 2.

Screenshot of the app' modal using OAuth2.

Actualizar tus URL de redirección

¿Tienes una nueva URL de redireccionamiento? Puedes actualizar estas configuraciones en tu entorno de trabajo de ClickUp en cualquier momento.
  1. En la esquina inferior izquierda, haz clic en tu avatar del entorno de trabajo.
  2. Selecciona Integraciones.
  3. Haz clic en ClickUp API.
  4. Expande la aplicación para mostrar sus detalles.
  5. Actualiza tu aplicación:
    • Agrega o actualiza las URL de redireccionamiento.
    • Haz clic en Guardar.

Ver o regenerar tu secreto de cliente

¿Quieres regenerar tu secreto de cliente? Puedes hacerlo en cualquier momento.
  1. Haz clic en tu avatar del entorno de trabajo en la esquina inferior izquierda
  2. Selecciona Integraciones
  3. Haz clic en ClickUp API
  4. Expande la aplicación para mostrar sus detalles
  5. Haz clic en Mostrar para ver tu Secreto de Cliente actual
  6. Haz clic en Regenerar para crear inmediatamente un nuevo secreto de cliente
  7. Actualiza tu aplicación para utilizar el nuevo secreto de cliente

Tipos de tokens de autorización

Los tokens te permiten realizar llamadas a la API e integrarte con otras aplicaciones. También puedes usar aplicaciones como Make para crear integraciones sin escribir código. Los tokens son específicos para tu cuenta de usuario de ClickUp.
Cualquier persona con una cuenta de ClickUp puede generar un token personal. Los tokens personales permiten el acceso a todos los entornos de trabajo que tu cuenta haya creado o unido. Tu token personal te brinda el mismo acceso que tienes a través de un navegador web.
Si utilizas OAuth 2, puedes elegir autorizar el acceso a entornos de trabajo específicos cuando te autenticas por primera vez o cuando vuelvas a autenticarte más tarde.
Screenshot of someone selecting which Workspaces to authorize with OAuth2.

Actualización

¿Fue útil este artículo?