Para desenvolvedores

Coloque a portaria inteligente Zibox dentro do app da sua marca.

Uma API white-label para operar os armários Zibox pelo seu próprio produto: leia kiosks e apartamentos, atualize contatos e senhas, e receba cada entrega e retirada em tempo real — com a sua marca, no seu app.

Ver a API Falar com a gente

O que dá pra fazer

Tudo o que a operação precisa, via API

Ler kiosks & apartamentos

Liste os armários da sua conta e os apartamentos de cada um, com status online e dados de contato.

Atualizar contatos e senha

Altere os telefones de WhatsApp e a senha de um apartamento — a mudança viaja até o armário sozinha.

Eventos em tempo real

Receba entrega.criada, retirada.criada e kiosk.online/offline por webhook, assinados com HMAC.

Isolado por conta

Multi-tenant: sua chave só enxerga os kiosks da sua conta. Fora do escopo, 403.

Como funciona

Do zero ao primeiro evento em 3 passos

1
Peça acesso de integrador
Fale com a gente para abrir sua conta de integrador. A gente libera sua chave zint_… (escopo ⊆ o da sua conta) e um armário de teste.
2
Chame /v1/integration/*
Autentique cada requisição com Authorization: Bearer zint_…. Base: https://api.zibox.com.br.
3
Receba webhooks assinados
Cadastre uma URL e receba cada evento com o header X-Zibox-Signature (HMAC-SHA256). Entrega at-least-once — deduplique pelo event_id.

Exemplo — listar seus kiosks

curl -H "Authorization: Bearer zint_SEU_TOKEN" \
  https://api.zibox.com.br/v1/integration/kiosks

Precisa da lista completa de rotas? Veja a referência da API →

Modo teste

Um armário de teste só seu, isolado da frota real

Sua conta de integrador vem com um armário fictício (test mode estilo Stripe). Use chaves zint_test_, dispare entregas e retiradas pelo simulador e valide a integração ponta a ponta — com payload e assinatura HMAC idênticos aos de produção. Nada aqui toca a frota real.

O acesso ao sandbox é liberado sob solicitação — fale com a gente para receber sua conta de teste.

Pedir uma conta de teste

Para IAs e agentes

Integre com ajuda de IA

Vai integrar com Claude, Cursor ou outro assistente? Aponte-o para a nossa llms.txt: um documento único em Markdown que descreve a integração inteira — rotas, modo sandbox e como receber e verificar webhooks.

https://api.zibox.com.br/llms.txt

Abrir llms.txt ↗Abrir openapi.json ↗

Pronto para integrar?

Comece pela referência da API ou fale com a gente para abrir sua conta de integrador.

Referência da API Falar com vendas