Integre Ferramentas Externas com o Quire via API Quire — Usando o n8n como Exemplo

Última atualização: 20 de julho de 2026

O Quire oferece uma API aberta que permite ler e atualizar tarefas do Quire programaticamente. Muitos aplicativos no Diretório de Aplicativos são construídos interagindo diretamente com a API Quire.

Se um aplicativo existente não atender às suas necessidades, construa uma integração personalizada. Este artigo percorre a API Quire usando o n8n como exemplo de plataforma de automação; os mesmos conceitos se aplicam a outras plataformas low-code, como o Zapier.

Esse caminho está cada vez mais se tornando a norma. O Gartner estimou que, até 2025, 70% das novas aplicações desenvolvidas por organizações usariam tecnologias low-code ou no-code, ante menos de 25% em 2020. O n8n é uma das opções open-source mais usadas nessa categoria.

Endpoints da API Quire usados neste guia

Quais São as Etapas de Implementação?

1. Criar um aplicativo no Quire para obter credenciais de API
2. Preparar e executar uma instância do n8n
3. Autenticar com OAuth2 no n8n
4. Enviar uma primeira requisição de API (ler tarefas)
5. Criar ou modificar tarefas via API (escrita)
6. Usar sourceRef para armazenar referências de origem ou metadados personalizados

1. Criar um aplicativo no Quire

Para acessar a API Quire, você precisa registrar um aplicativo no Quire, obter um client ID e client secret, e configurar uma URI de redirecionamento para o OAuth2.

Para um guia passo a passo sobre como criar seu aplicativo Quire com API, visite nosso post do blog.

2. Preparar o n8n

Você pode hospedar o n8n por conta própria (gratuito) para testes. Confira este documento oficial.

Uma vez em execução, crie um novo fluxo de trabalho onde você adicionará nós para realizar requisições de API e processar as respostas.

3. Autenticar com OAuth2

O Quire usa OAuth2 para autorização. O n8n ajuda gerenciando a troca de tokens para você quando você cria uma credencial.

• Na visualização do fluxo de trabalho, adicione uma nova credencial e escolha a opção OAuth2.

• Preencha o client ID, client secret, URL de autorização, URL de token e URI de redirecionamento a partir das configurações do seu aplicativo Quire. A URI de redirecionamento deve ser copiada do n8n e colada nas configurações do seu aplicativo Quire para garantir o fluxo correto do OAuth2. No n8n, é preciso definir o campo "Authentication" como Body para garantir que as credenciais sejam enviadas no formato correto exigido pelo Quire.

• Clique em Connect to my account, e o n8n redirecionará você para a página de autorização do Quire. Escolha o projeto a autorizar e conclua o fluxo.

4. Enviar sua primeira requisição de API (ler tarefas)

Documentação da API Quire: https://quire.io/dev/api/

Use o nó HTTP Request do n8n para chamar a API. Como exemplo, obtenha todas as tarefas raiz de um projeto:

• URL base: https://quire.io/api
• Endpoint: /task/list/id/{projectId} (substitua {projectId} pelo ID do projeto encontrado na URL do seu projeto, geralmente https://quire.io/w/<projectId>)

No nó HTTP Request:

• Método: GET
• URL: https://quire.io/api/task/list/id/<your_project_id>
• Authentication: Generic Credential Type
• Generic Auth Type: OAuth2 API
• OAuth2 API: <a credencial que você acabou de criar>

Execute o nó para ver os dados de resposta no painel à direita; você pode passar esses dados para os nós seguintes para processamento.

5. Criar ou modificar tarefas (escrita)

Você pode criar tarefas usando a API (veja Adicionar uma nova tarefa na documentação).

• Endpoint: /task/id/{projectId}

No nó HTTP Request do n8n:

• Método: POST
• URL: https://quire.io/api/task/id/<your_project_id>
• Ative Send Body e forneça os campos obrigatórios (por exemplo, name) e campos opcionais como description.

Depois de ativar Send Body, certifique-se de definir Body Content Type como JSON e Specify Body como Using JSON. Isso permite inserir o corpo da requisição em formato JSON, correspondendo ao código de exemplo abaixo:

{
  "name": "Example task",
  "description": "Created via n8n"
}

Execute o nó; a resposta conterá os detalhes da tarefa criada e você deverá ver a tarefa no seu projeto Quire.

6. Usar o sourceRef para referências de origem e dados personalizados

Exemplo de corpo de requisição com sourceRef:

{
  "name": "Task from n8n",
  "description": "Automated task",
  "sourceRef": {
    "text": "[Open in MyApp](https://example.com/item/123)",
    "meta": { "workflowId": "n8n-abc-123" }
  }
}

sourceRef é projetado para armazenar dados personalizados relacionados a uma tarefa. O único campo predefinido é text, que suporta Markdown e será exibido nos detalhes da tarefa no Quire, perfeito para links ou descrições curtas em que os usuários podem clicar.

Quaisquer outros campos que você adicionar em sourceRef ficam totalmente a critério da sua aplicação; por exemplo, você pode incluir um objeto meta ou outras chaves para armazenar identificadores ou sinalizadores para sua automação, mas isso é opcional.

Ao ler uma tarefa via API, procure pelo objeto sourceRef no JSON retornado. Você pode acessar o campo text e quaisquer dados personalizados que tenha armazenado, facilitando o rastreamento da origem pela sua automação e o transporte de informações extras para processamento posterior.

Outro campo útil ao criar ou atualizar uma tarefa é asUser.

Se você definir asUser como true, o registro de atividade mostrará o nome do aplicativo Quire como o usuário que criou ou atualizou a tarefa. Isso ajuda os usuários a identificar quais tarefas foram criadas por uma integração de API.

Como Você Trata Erros da API Quire?

Quatro códigos de status HTTP respondem por praticamente todos os problemas que você encontrará ao chamar a API Quire. Cada um tem uma solução específica:

• 401 Unauthorized: Verifique se seu token OAuth2 é válido e não expirou. Confirme se a configuração da sua credencial está correta.
• 400 Bad Request: Revise o corpo e os parâmetros da sua requisição. Certifique-se de que o formato JSON está correto e que os campos obrigatórios estão incluídos.
• 403 Forbidden: Confirme se o seu aplicativo e usuário têm permissão para acessar o projeto ou recurso.
• 404 Not Found: Verifique novamente o endpoint da API e os IDs de projeto/tarefa que você está usando.

Sempre consulte a documentação da API Quire para detalhes sobre mensagens de erro e parâmetros obrigatórios. Se encontrar um erro, leia a mensagem de resposta com atenção. Ela costuma trazer pistas sobre o que deu errado.

Como Implementar a Sincronização Bidirecional com a API Quire?

Como descrito no artigo referenciado, você também pode construir sua própria solução de sincronização bidirecional usando o n8n e a API Quire.

Para um exemplo prático, confira nosso repositório open-source: n8n Quire API. O repositório oferece um guia passo a passo e um modelo funcional, facilitando a implementação da sincronização bidirecional entre seu aplicativo e o Quire.

Para um guia passo a passo sobre como construir a sincronização bidirecional com a API Quire, visite nosso post do blog.

Qual É o Próximo Passo?

Agora você tem o que precisa para ler tarefas, criar tarefas, anexar metadados de origem com sourceRef e identificar sua integração no registro de atividade com asUser. Os mesmos padrões se estendem a outros endpoints da API Quire; a documentação oficial da API é a referência definitiva.

Se você encontrar problemas, a seção de tratamento de erros acima cobre as quatro respostas HTTP mais comuns. Para qualquer outra coisa, envie um e-mail para feedback@quire.io.

Relacionado: Configuração do Quire MCP em 5 Minutos: Conecte Claude, ChatGPT ou Qualquer Cliente de IA — se você quer que um cliente de IA trabalhe diretamente com o Quire em vez de escrever chamadas de API personalizadas, o MCP é o caminho mais rápido.

Relacionado: Um Guia Passo a Passo para Configurar Webhooks do Quire — os webhooks enviam atualizações para sua automação no momento em que algo muda no Quire, em vez de seu fluxo de trabalho precisar consultar a API repetidamente.

Perguntas Frequentes

O que é a API Quire e o que posso fazer com ela?

É uma API aberta para ler e atualizar tarefas do Quire programaticamente. Use-a para criar integrações personalizadas quando um aplicativo existente no Diretório de Aplicativos não atender às suas necessidades.

Como faço a autenticação com a API Quire?

O Quire usa OAuth2. Registre um aplicativo Quire, obtenha o client ID e o secret, e defina o campo de autenticação do n8n como Body para que as credenciais sejam enviadas no formato que o Quire espera.

Posso usar o n8n para integrar com o Quire?

Sim. Hospede o n8n gratuitamente por conta própria ou use o n8n.cloud, e então use nós HTTP Request com credenciais OAuth2 para ler e escrever tarefas. Os mesmos padrões se aplicam ao Zapier e a plataformas semelhantes.

O que é o sourceRef na API Quire?

sourceRef armazena dados personalizados em uma tarefa. O campo predefinido text suporta Markdown e é exibido nos detalhes da tarefa, e você pode anexar quaisquer outras chaves, como meta, para rastrear a origem ou carregar metadados da automação.

O que devo verificar quando a API Quire retorna um erro?

401 indica problemas com o token, 400 indica um corpo de requisição inválido, 403 indica problemas de permissão e 404 indica um endpoint ou ID incorreto. Leia a mensagem de resposta. Ela geralmente aponta para a solução.