Se você usa um sistema próprio, uma planilha automatizada ou uma integração feita sob medida para cadastrar produtos, a Hango Food oferece uma API pública para isso. O acesso é feito por uma chave de API, gerada pela pessoa proprietária da loja.
1. Acesse a tela de API
Acesse:
Configurações → Integrações, e clique em API Pública, na seção "Utilidades".
Esse card só aparece para a pessoa Proprietária da empresa — nem administradores, nem qualquer outro nível de acesso conseguem ver ou gerar chaves de API. É a única área do sistema com essa restrição.
2. Gere uma nova chave
Clique em Gerar nova chave e dê um nome que ajude você a lembrar depois para que serve, por exemplo "Integração ERP" ou "Planilha de estoque".
Ao confirmar, a chave é exibida uma única vez, em uma janela com um botão para copiar. Copie e guarde esse valor em um local seguro — ele não pode ser exibido novamente. Se você perder a chave, não tem problema: basta gerar uma nova e revogar a antiga (veja o passo 4).
3. Use a chave na sua integração
O time técnico responsável pela integração deve enviar a chave no cabeçalho
Authorization: Bearer sua-chave-aqui em cada chamada à API.
Clique em Ver documentação da API, na mesma tela, para abrir a referência completa com todos os endpoints disponíveis, os campos aceitos e as respostas esperadas — esse link pode ser compartilhado diretamente com o time técnico da integração, mesmo que essa pessoa não tenha um acesso ao painel da Hango Food.
Pela API é possível criar ou atualizar um produto simples do cardápio (o próprio sistema evita duplicar: se você reenviar o mesmo SKU ou nome, o produto existente é atualizado em vez de criado de novo), com uma ou mais variações de preço (por exemplo, Pequena/Média/Grande), ativar ou desativar um produto, e anexar uma foto por meio de uma URL.
Cada atualização substitui por completo as variações de preço do produto pelas que forem enviadas naquela chamada — uma variação que existia antes e não for reenviada é removida do produto, então a integração deve sempre enviar a lista completa de variações que devem existir.
4. Revogue uma chave
Se uma chave não for mais necessária — por exemplo, a integração foi desligada, ou você suspeita que a chave vazou — clique em Revogar na lista de chaves. Uma janela de confirmação é exibida antes de qualquer alteração.
Ao confirmar, qualquer sistema que ainda esteja usando essa chave passa a receber erro de autenticação imediatamente. Essa ação não pode ser desfeita — para voltar a integrar, é necessário gerar uma nova chave.
Precisa de mais informações?
Se o time técnico da sua integração relatar erro de autenticação, confira nesta tela se a chave usada ainda está ativa (não aparece como revogada). Se o erro for de limite de requisições, a API aceita até 60 chamadas por minuto por chave — distribua os envios ao longo do tempo em vez de disparar tudo de uma vez.