API e Webhooks do KitHub
Sim, o KitHub tem API pública. E webhooks.
Os dados da sua cozinha são seus. Ligue o KitHub ao Claude Code, ao Codex, ao n8n ou ao seu ERP — leia etiquetas, checklists, ponto e inventário, e receba um aviso na hora em que algo acontece. Sem exportar planilha e sem precisar falar com vendas.
O jeito mais rápido de começar
Deixe seu agente de IA escrever a integração
A API é descrita em OpenAPI 3.1 — o formato que Claude Code, Codex e ferramentas parecidas leem sozinhos. Em vez de estudar a documentação, aponte o agente para a especificação e diga o que você quer. Ele descobre as rotas, os campos e a paginação.
Funciona porque a especificação é completa: rotas, parâmetros, formato de resposta, erros e limites estão todos declarados nela.
Nada de raspar tela
O agente conversa com um contrato estável em JSON. Nada de print de planilha, PDF exportado ou automação que quebra quando a tela muda de lugar.
Escopo controlado
A chave só alcança os módulos que o seu plano contrata, e é revogável a qualquer momento. Seu agente não recebe mais acesso do que você quer dar.
O que a API entrega
Quatro domínios da operação
Leitura em REST, resposta em JSON, paginação por cursor e sincronização incremental por data.
Etiquetas
Produtos e insumos, grupos, tipos de conservação com o prazo de cada um, e cada etiqueta de validade impressa — com produto, responsável, datas e código de rastreio.
Checklists
Modelos cadastrados e cada execução agendada ou realizada, com os números de conformidade. O detalhe traz item a item.
Ponto
Marcações registradas, imutáveis por exigência da Portaria 671 — um ajuste aprovado não reescreve a marcação original, e a API mostra isso.
Inventário
Saldo atual por produto e local de armazenamento, mais o histórico de entradas, saídas e ajustes, com sinal para somar direto.
Leitura, não escrita. É decisão de projeto: as regras de negócio vivem no aplicativo, e um endpoint de escrita seria uma segunda implementação delas, livre para divergir. A API serve para levar o dado do KitHub para onde você precisa — ERP, BI, planilha, automação.
Integração em tempo real
Webhooks: o KitHub avisa você
Em vez de ficar consultando de tempos em tempos, você cadastra um endereço e o KitHub faz um POST assim que algo acontece. É o que liga a cozinha ao n8n, ao Make, ao seu ERP ou a um fluxo interno — sem ninguém digitando nada duas vezes.
- label.createdUma etiqueta de validade foi impressa
- label.deletedUma etiqueta foi excluída
- product.createdProduto novo cadastrado
- product.updatedProduto teve dados relevantes alterados
- product.deletedProduto excluído
- checklist_run.completedExecução de checklist concluída
- timeclock.punch.createdMarcação de ponto registrada
Um destino por assunto
O administrador cadastra em API e Integrações → Webhooks e escolhe quais eventos cada destino recebe. O ERP só produtos, a contabilidade só ponto — cada um com fila e reenvio próprios.
Assinado, para você confiar
Cada entrega vem com assinatura HMAC-SHA256 no cabeçalho. Conferindo a assinatura, você sabe que o aviso veio do KitHub e que o conteúdo não foi alterado no caminho.
Não perde entrega
Se o seu sistema estiver fora do ar, o KitHub tenta de novo — 1, 3, 9, 27 e 81 minutos, cobrindo cerca de duas horas. Cada entrega tem um identificador para você ignorar repetições.
Avisa quando quebra
Se o destino falhar 20 vezes seguidas, ele é desativado e os administradores recebem notificação no app. Você fica sabendo que a integração parou, em vez de descobrir semanas depois.
Para quem automatiza com IA
E sobre MCP?
O Model Context Protocol é o padrão que permite a um agente de IA consultar um sistema de forma estruturada e segura, em vez de raspar tela.
Sendo direto: servidor MCP publicado, ainda não temos. Mas a parte difícil já está feita. Um servidor MCP é uma camada fina sobre uma API bem definida — e a nossa já existe, está documentada em OpenAPI e tem autenticação, escopo por plano e limite de uso. Se a sua operação precisa de MCP, fale com a gente: partimos da API que já está no ar.
Enquanto isso, o caminho de hoje funciona bem: aponte o Claude Code ou o Codex para a especificação e deixe ele montar a ponte que a sua operação precisa.
Perguntas frequentes
Dúvidas sobre a API e os webhooks
A API é paga à parte?
Não. Ela acompanha o plano Pro do módulo que você quer ler. Se você tem Pro de Etiquetas, os endpoints e os eventos de etiquetas funcionam; os demais ficam indisponíveis até você contratar o módulo.
Preciso falar com vendas para ter acesso?
Não. Crie sua conta, contrate o módulo Pro que precisa e gere a chave você mesmo, em API e Integrações.
Como gero a chave?
No app, em API e Integrações, com um usuário administrador da empresa. O segredo aparece uma única vez na criação — guarde na hora. Perdeu? Gere outra e revogue a anterior.
Dá para usar com n8n, Make ou Zapier?
Sim. Para ler, é um nó HTTP com o header X-Kithub-Api-Key e paginação por cursor. Para reagir na hora, aponte um webhook do KitHub para a URL do seu fluxo.
Dá para escrever dados pela API?
Hoje não — a v1 é somente leitura, e isso é decisão de projeto. Cadastrar e editar continua sendo pelo app, onde as regras de negócio vivem. Se o seu caso exige escrita, conte para a gente qual.
Meu endpoint exige token para aceitar a chamada. Funciona?
Funciona. Ao cadastrar o destino você escolhe como o KitHub se autentica no seu lado: sem autenticação, Bearer token, cabeçalho personalizado ou usuário e senha. Isso é além da assinatura, que continua valendo.
Seus dados, no seu sistema.
Crie a conta, contrate o módulo e gere a chave você mesmo. A documentação é aberta — dá para avaliar a API antes de assinar.