Como habilitar e usar a API Pública do Deli para integrar sistemas externos: ativação, criação de token, documentação técnica e boas práticas de segurança.
Quer integrar o Deli a outros sistemas externos? Precisa que um desenvolvedor automatize relatórios, controle o estoque ou leia vendas a partir da sua conta?
Com a API Pública de propósito geral, você pode fazer isso com segurança e controle total sobre os acessos. Agora, além disso, você pode habilitá-la você mesmo pelo Deli, sem enviar formulários nem esperar que uma equipe libere o acesso para você.
⭐Essa funcionalidade está disponível no Plano Pro
✅ O que é a API Pública?
É uma ferramenta para conectar a Deli com outras aplicações. Com ela, você pode consultar informações sobre Clientes, Descontos, Categorias de Despesas, Despesas, Ingredientes, Itens, Cozinhas, Pagamentos, Métodos de Pagamento, Pedidos, Categorias de Produtos, Modificadores de Produtos, Produtos, Fornecedores, Usuários, Salões, Vendas, Subitens, Mesas e Usuários.
É usada principalmente para:
Ler vendas ou produtos a partir de sistemas externos.
Automatizar relatórios personalizados.
Integrar com plataformas de IA, BI, ERPs ou outros sistemas próprios.
Como ativar e utilizar a API do Deli
🔐 Passo 1: Habilitar a API Pública pelo Sistema Deli
A habilitação da API Pública é feita diretamente pelo Sistema Deli. Não é mais necessário preencher um formulário nem esperar que o Deli libere o acesso para você.
Acesse Aplicações Externas > API Pública Geral.
Se sua conta não tiver o Plano Pro, você verá uma tela convidando você a fazer upgrade do plano para acessar essa funcionalidade.
Se sua conta tiver o Plano Pro, você poderá habilitar a API Pública nessa mesma tela.
O sistema perguntará para qual finalidade você vai usar a API. Preencha essa informação e avance.
Ao confirmar, a API Pública fica habilitada. Ela aparecerá marcada em verde, pronta para uso.
🔧 Passo 2: Criar o token de acesso
Depois que a API for habilitada, siga estes passos para gerar um token de autenticação:
Acesse Configurações > Usuários.
Crie um novo usuário. Certifique-se de que ele tenha as permissões necessárias para o que você vai precisar acessar pela API.
Selecione o usuário criado e edite-o.
Você poderá visualizar a API Key. Copie-a e guarde-a.
Clique no botão Estabelecer para gerar a API Secret.
Será exibida uma chave (token) que você deve copiar e salvar imediatamente.
Clique em Aceitar.
⚠️ Atenção: se você perder o token, precisará gerar um novo.
⏳ Quanto tempo dura o token?
Por padrão, o token vence em 24 horas. A renovação pode ser feita diretamente pela própria API.
🔎 Dica: você também pode invalidar um token quando quiser, basta excluí-lo na seção de usuários.
📘 Documentação técnica (para desenvolvedores)
Nossa API segue o padrão OpenAPI 3, o que facilita a integração com sistemas modernos.
👉 Acesse a documentação oficial aqui: https://dev.fu.do/api
💡 Nessa página, os desenvolvedores podem ver todos os endpoints disponíveis, com exemplos de uso e possíveis respostas.
🧠 Recomendações de segurança
Revise as permissões atribuídas ao usuário: se ele não tiver permissão para ver vendas, também não poderá fazê-lo pela API.
Revogue tokens antigos que não sejam mais necessários.
Leve em conta
A API Pública está disponível somente para contas com o Plano Pro.
O usuário de API é criado e gerenciado em Configurações > Usuários, assim como qualquer outro usuário.
Se você perder a API Secret, não será possível recuperá-la: será necessário gerar uma nova.
O que acontece depois de habilitar a API Pública
Depois de habilitada, você já pode criar o usuário de API em Usuários e gerar o token de acesso para começar a integrar o Deli aos seus sistemas externos, seguindo a documentação técnica disponível em https://dev.fu.do/api.
Perguntas frequentes
Preciso preencher um formulário para solicitar a API Pública?
Não. A habilitação não é mais solicitada por formulário: ela é feita diretamente pelo Deli, em Aplicações Externas > API Pública Geral
O que acontece se eu não tiver o Plano Pro?
Você verá uma tela convidando você a fazer upgrade do seu plano. Somente contas com o Plano Pro podem habilitar e usar a API Pública.
Quanto tempo leva para a API ser ativada depois que eu a habilito?
Ela fica habilitada instantaneamente: ao confirmar para qual finalidade você vai usá-la, a API é ativada e aparece marcada em verde.