API pública do Brasahub
Uma API de leitura para levar os dados da sua operação para onde você já trabalha: ERP, BI, planilha ou um agente próprio. Disponível no plano Full, com chave emitida por você e revogável a qualquer momento.
Base
https://fzqhxzzifujdwjtyvfjw.supabase.co/functions/v1/public-apiAutenticação
Gere a chave no sistema em Configurações → API e Webhooks. Ela aparece uma única vez. Envie no header:
Authorization: Bearer bh_live_...A chave responde só pelos dados do seu estabelecimento. Se a assinatura sair do plano Full ou a chave for revogada, a resposta vira 401 na chamada seguinte.
Endpoints
| Endpoint | O que devolve | Filtros |
|---|---|---|
GET /orders | Pedidos do estabelecimento, do mais recente para o mais antigo. | limit (1–200), since (ISO 8601) |
GET /sales | Vendas registradas no PDV e no fechamento de conta. | limit (1–200), since (ISO 8601) |
GET /products | Catálogo de produtos, em ordem alfabética. | limit (1–200) |
A resposta é sempre { "data": [...], "count": n }. Somente leitura: escrever pedido de fora exige decidir estoque, impressão e KDS, e isso ainda não está definido.
Limites
- 600 requisições por minuto por IP.
- 240 requisições por minuto por estabelecimento.
- Ao estourar, a resposta é
429comretry_afterem segundos.
Webhooks
Na mesma tela do sistema você cadastra uma URL para receber eventos assim que acontecem, em vez de ficar consultando a API.
Para agentes e ferramentas
- Especificação OpenAPI: https://brasahub.com.br/openapi.json
- Autenticação em markdown: https://brasahub.com.br/auth.md
- Catálogo de APIs (RFC 9727): https://brasahub.com.br/.well-known/api-catalog
- Qualquer página de conteúdo do site responde em markdown para quem manda
Accept: text/markdown.
Dúvida de integração: suporte@brasahub.com.br.