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 só pode acessar o conteúdo disponível para sua conta individual de usuário do ClickUp.

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ê precisa ser proprietário do espaço de trabalho ou administrador para gerenciar as configurações de integração. Para fazer isso:
  1. No canto superior direito, clique no seu avatar pessoal.
  2. Selecione Configurações
  3. Na barra lateral, selecione API ClickUp.
  4. Clique em + Criar novo aplicativo.
  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 de 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 direito, clique no seu avatar pessoal.
  2. Selecione Configurações
  3. Na barra lateral, 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 direito, clique no seu avatar pessoal.
  2. Selecione Configurações
  3. Na barra lateral, selecione IA 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.

Esse artigo foi útil?