Integre Ferramentas Externas com o Quire através da API Quire — Usando o n8n como Exemplo

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

O Quire disponibiliza uma API aberta que permite ler e atualizar tarefas do Quire programaticamente. Muitas aplicações no Diretório de Aplicações são construídas interagindo diretamente com a API Quire.

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

Esta abordagem é cada vez mais a norma. A Gartner estimou que, até 2025, 70% das novas aplicações desenvolvidas por organizações usariam tecnologias low-code ou no-code, face a menos de 25% em 2020. O n8n é uma das opções open-source mais utilizadas nessa categoria.

Endpoints da API Quire usados neste guia

Quais São os Passos de Implementação?

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

1. Criar uma aplicação no Quire

Para aceder à API Quire, precisa de registar uma aplicação no Quire, obter um client ID e client secret, e configurar um URI de redirecionamento para o OAuth2.

Para um guia passo a passo sobre como criar a sua Quire com API, visite a nossa publicação no blog.

2. Preparar o n8n

Pode hospedar o n8n por conta própria (gratuito) para testes. Pode consultar este documento oficial.

Depois de estar em execução, crie um novo workflow onde irá adicionar nós para efetuar pedidos à API e processar as respostas.

3. Autenticar com OAuth2

O Quire usa OAuth2 para autorização. O n8n ajuda ao gerir a troca de tokens por si quando cria uma credencial.

• Na vista do workflow, 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 definições da sua Quire. O URI de redirecionamento deve ser copiado do n8n e colado nas definições da sua Quire para garantir o fluxo OAuth2 correto. No n8n, tem de definir o campo "Authentication" como Body para garantir que as credenciais são enviadas no formato correto exigido pelo Quire.

• Clique em Connect to my account; o n8n irá redirecioná-lo para a página de autorização do Quire. Escolha o projeto a autorizar e conclua o fluxo.

4. Enviar o seu primeiro pedido à 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 a partir do 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 acabou de criar>

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

5. Criar ou modificar tarefas (escrita)

Pode criar tarefas usando a API (veja Add a new task 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 que define Body Content Type como JSON e Specify Body como Using JSON. Isto permite-lhe inserir o corpo do pedido 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 deverá ver a tarefa no seu projeto Quire.

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

Exemplo de corpo do pedido 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 foi concebido para armazenar dados personalizados relacionados com uma tarefa. O único campo predefinido é text, que suporta Markdown e é mostrado nos detalhes da tarefa no Quire, perfeito para links ou breves descrições em que os utilizadores podem clicar.

Quaisquer outros campos que adicione sob sourceRef dependem inteiramente da sua aplicação; por exemplo, pode incluir um objeto meta ou outras chaves para armazenar identificadores ou marcadores para a sua automação, mas estes são opcionais.

Ao ler uma tarefa através da API, procure o objeto sourceRef no JSON devolvido. Pode aceder ao campo text e a quaisquer dados personalizados que tenha armazenado, facilitando à sua automação o rastreio da origem e o transporte de informação adicional para processamento posterior.

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

Se definir asUser como true, o registo de atividade mostrará o nome da aplicação Quire como o utilizador que criou ou atualizou a tarefa. Isto ajuda os utilizadores a identificar quais tarefas foram criadas por uma integração de API.

Como Tratar Erros da API Quire?

Quatro códigos de estado HTTP explicam praticamente todos os problemas que irá encontrar ao chamar a API Quire. Cada um tem uma solução específica:

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

Consulte sempre 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. Frequentemente contém pistas sobre o que correu mal.

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

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

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

Para um guia passo a passo sobre como construir sincronização bidirecional com a API Quire, visite a nossa publicação no blog.

Qual É o Próximo Passo?

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

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

Relacionado: Configuração do Quire MCP em 5 Minutos: Ligue o Claude, o ChatGPT ou Qualquer Cliente de IA — se quiser que um cliente de IA trabalhe diretamente com o Quire em vez de escrever chamadas de API personalizadas, o MCP é a via mais rápida.

Relacionado: Um Guia Passo a Passo para Configurar Webhooks do Quire — os webhooks enviam atualizações para a sua automação no momento em que algo muda no Quire, em vez de o seu workflow ter de 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 construir integrações personalizadas quando nenhuma aplicação existente no Diretório de Aplicações se adequar.

Como me autentico com a API Quire?

O Quire usa OAuth2. Registe uma aplicação 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 ou use o n8n.cloud, e depois use nós HTTP Request com credenciais OAuth2 para ler e escrever tarefas. Os mesmos padrões aplicam-se ao Zapier e a plataformas semelhantes.

O que é o sourceRef na API Quire?

sourceRef armazena dados personalizados numa tarefa. O campo predefinido text suporta Markdown e é mostrado nos detalhes da tarefa, e pode anexar quaisquer outras chaves como meta para rastrear a origem ou transportar metadados de automação.

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

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