Bem-vindo
Comece aqui: o que a API faz, como autenticar e o caminho mais rápido para a primeira requisição.
A API da Hubiss conecta o seu sistema (ERP, planilha ou plataforma própria) à plataforma: você cadastra lojas, categorias, marcas, produtos e fotos, e recebe pedidos dos marketplaces sem digitar nada duas vezes.
Em resumo
Base URL
https://api.hubiss.com.br/v1 · autenticação por Authorization: Bearer SEU_TOKEN · respostas em JSON · 20 registros por página (máximo 20) · sem limite de requisições por token.O que você consegue fazer
| Recurso | Para quê serve |
|---|---|
| Lojas | Criar a estrutura que agrupa categorias e produtos |
| Categorias | Montar a árvore de categorias de cada loja |
| Marcas | Vincular produtos a fabricantes |
| Produtos | Cadastrar e atualizar itens, incluindo variações e fotos |
| Pedidos | Ler pedidos do marketplace, faturar, enviar e concluir |
| Webhooks | Ser avisado em tempo real quando algo muda |
Sua primeira requisição em 3 passos
- Gere o token no painel da Hubiss (ícone do usuário → Token API → Gerar Token). Veja Autenticação.
- Envie a requisição abaixo, trocando
SEU_TOKENpelo valor gerado. - Confira a resposta:
200com uma lista paginada significa que está tudo certo.
Exemplo em linha de comandobash
curl --request GET \
--url 'https://api.hubiss.com.br/v1/stores' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN'
Resposta esperada (resumida):
JSONjson
{
"data": [
{
"id": "1",
"name": "Minha loja",
"status": "active"
}
],
"links": { "next": null },
"meta": { "current_page": 1, "total": 1 }
}
Recebeu 401?
O token está ausente, inválido ou foi substituído por um novo. Ao gerar um token, o anterior deixa de funcionar imediatamente. Veja Erros.
Ordem que funciona
O cadastro tem dependência real entre recursos. Siga a sequência:
Cada etapa depende da anterior: não existe produto sem loja e categoria.
Próximo passo
Leia o Fluxo completo de integração para ver cada etapa com payload, resposta e erros comuns.
Versão da API
Existe uma única versão pública, v1, e o compromisso é não quebrar integrações existentes. Mudanças incompatíveis só aconteceriam em uma versão nova.