n8n-nodes-knack-api-gbastian

Este é um node customizado para n8n que permite integração completa com a API do Knack, com sistema inteligente de operadores dinâmicos e suporte estendido para todos os tipos de campos.

Recursos Principais

🎯 Sistema de Operadores Dinâmicos (v33.1.0)

• Operadores se ajustam automaticamente ao tipo de campo
• Mais de 40 operadores especializados
• Interface intuitiva com campos dinâmicos

📝 Operações Suportadas

• Records (Registros)

  • Criar novos registros
  • Obter registro por ID
  • Obter todos os registros (com paginação automática)
  • Atualizar registros existentes
  • Deletar registros

• Search (Busca)

  • Buscar registros com filtros avançados
  • Operadores dinâmicos por tipo de campo
  • Suporte para buscas complexas (range, período, localização)

• Objects (Objetos)

  • Listar todos os objetos da aplicação

🔧 Tipos de Campos Suportados

• Text, Email, Phone, URL
• Number, Currency, Percentage, Rating
• Date, DateTime (com operadores de período)
• Boolean (Sim/Não)
• Multiple Choice
• Connection (relacionamentos)
• Address (com busca por proximidade)
• Name (primeiro, meio, último)
• File/Image Upload
• Rich Text, Paragraph Text
• Timer, Auto Increment
• E mais...

Instalação

Em n8n local

1. Clone este repositório:

git clone https://github.com/GuilhermekBastian/n8n_node_knack.git
cd n8n_node_knack

2. Instale as dependências e compile:

npm install
npm run build

3. Copie os arquivos compilados para a pasta de nodes customizados do n8n:

cp -r dist/* ~/.n8n/custom/

4. Reinicie o n8n

Via npm (quando publicado)

npm install n8n-nodes-knack-api-gbastian

Configuração

Credenciais

Este node suporta dois tipos de autenticação:

1. Knack API - Para operações gerais usando API Key

   • Application ID
   • REST API Key

2. Knack User API - Para operações específicas de usuário

   • User Token
   • Application ID

Desenvolvimento

Estrutura do Projeto

├── credentials/           # Arquivos de credenciais
├── nodes/                # Arquivos do node
│   └── Knack/
│       ├── knack.node.ts # Node principal
│       └── knack.svg     # Ícone
├── dist/                 # Arquivos compilados
├── package.json
└── tsconfig.json

Scripts Disponíveis

• npm run build - Compila o TypeScript e copia os ícones
• npm run dev - Modo de desenvolvimento com watch
• npm run lint - Verifica o código
• npm run format - Formata o código

Melhorias Planejadas

• [ ] Suporte para mais operações de busca avançada
• [ ] Melhor tratamento de erros
• [ ] Suporte para campos de arquivo/upload
• [ ] Paginação automática para grandes conjuntos de dados
• [ ] Cache de metadados de objetos e campos
• [ ] Testes unitários

Contribuindo

Contribuições são bem-vindas! Por favor:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -am 'Adiciona nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

Licença

ISC

Autor

BASTECH - Baseado no trabalho original de South Development (knack-api)