Pesquisa

Crie seu próprio aplicativo com a API da ClickUp

Quer criar um aplicativo que se integre ao ClickUp? Ofereça aos seus usuários a capacidade de fazer login usando OAuth 2.0! 
Confira também nossa documentação da API!

O que você vai precisar

Fluxo OAuth 2

Quando você deseja desenvolver um aplicativo que outros possam usar, deve utilizar um fluxo de autenticação OAuth2.
Com OAuth 2, todos que usam seu aplicativo recebem um token individualizado. Cada usuário pode acessar apenas o conteúdo disponível para sua conta de usuário ClickUp individual.

Se você não está familiarizado com OAuth2, a Digital Ocean preparou um ótimo guia que deve ajudá-lo a começar. Também recomendamos verificar o site do OAuth para detalhes adicionais.

Criar um aplicativo

O primeiro passo para usar OAuth 2 é criar um aplicativo no seu Espaço de trabalho. Você deve ser o proprietário do espaço de trabalho ou administrador para gerenciar as configurações de integração.
Para criar um aplicativo no seu espaço de trabalho:
  1. No canto superior esquerdo, clique no avatar do espaço de trabalho.
  2. Selecione Configurações. 
  3. Na barra lateral de configurações, selecione API ClickUp.
  4. No canto superior direito da página de Configurações da API do ClickUp, clique em Criar um Aplicativo.Captura de tela do botão Criar um Aplicativo.png
  5. Insira o nome do seu aplicativo e um URL(s) de redirecionamento.
    Se você não tem certeza de qual URL de redirecionamento usar, consulte o guia de URLs de Redirecionamento no site do OAuth.
  6. Clique em Criar Aplicativo.
  7. Na próxima tela, você verá que um ID do Cliente e um Segredo do Cliente foram gerados.
  8. Use o Client ID e o Client Secret em seu aplicativo para criar um fluxo de autenticação OAuth 2.

Captura de tela do modal do aplicativo usando OAuth2.

Atualize seuredirecionamento URL

Se você tiver uma nova URL de redirecionamento, pode atualizar essas configurações no seu Espaço de trabalho ClickUp a qualquer momento:
  1. No canto superior esquerdo, clique no avatar do espaço de trabalho.
  2. Selecione Configurações. 
  3. Na barra lateral de configurações, selecione API ClickUp.
  4. Clique em um aplicativo existente para expandir seus detalhes.
  5. Atualize a URL de redirecionamento.
  6. Clique em Salvar.

Visualize ou regenere seu segredo de cliente

Para regenerar o segredo do cliente:
  1. No canto superior esquerdo, clique no avatar do espaço de trabalho.
  2. Selecione Configurações. 
  3. Na barra lateral de configurações, selecione API ClickUp.
  4. Clique em um aplicativo existente para expandir seus detalhes.
  5. Clique em Mostrar para visualizar seu Cliente Secreto atual.
  6. Clique em Regenerate (Regenerar ) para criar um novo Client Secret.
  7. Atualize seu aplicativo para usar o novo Segredo do Cliente.

Tipos de token de autorização

Tokens permitem que você faça chamadas de API e integre com outras aplicações. Você também pode usar aplicativos como Make para criar integrações sem escrever código. Os tokens são específicos para sua conta de usuário no ClickUp.
Qualquer pessoa com uma conta ClickUp pode gerar um token pessoal. Tokens pessoais permitem acesso a todos os Espaços de Trabalho que sua conta criou ou participou. Seu token pessoal oferece o mesmo acesso que você tem através de um navegador web.
Se você usa OAuth2, pode escolher autorizar o acesso a Espaços de trabalho específicos quando autenticar pela primeira vez ou quando reautenticar mais tarde.
Captura de tela de alguém selecionando quais Espaços de Trabalho autorizar com OAuth2.