API Docs v1 api.hubiss.com.br

Autenticação

Como gerar o token, como enviá-lo em cada requisição e o que fazer quando ele deixa de funcionar.

Toda requisição precisa de um token da sua conta. Sem ele a API responde 401 — mesmo que a rota exista.

Passo a passo para gerar o token

  1. Entre no painel da Hubiss.
  2. Clique no ícone do usuário (canto superior direito).
  3. Escolha Token API.
  4. Clique em Gerar Token e confirme.
Gerar um token novo invalida o anterior
Ao confirmar, o token antigo para de funcionar imediatamente. Só o novo passa a valer. Atualize o seu sistema na mesma janela.
A Hubiss não consegue recuperar token
O token não é armazenado em texto legível. Guarde-o em local seguro — de preferência em um gerenciador de segredos. Se perder, gere outro.

Como enviar o token

O padrão é Bearer: o token vai em um cabeçalho Authorization em toda chamada.

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'
Cabeçalho Valor Obrigatório
Authorization Bearer SEU_TOKEN Sim
Accept application/json Recomendado
Content-Type application/json Sim em POST/PUT/PATCH

O que acontece quando o token falha

Status Significado O que fazer
401 Token ausente, inválido ou substituído Gerar novo token e atualizar o sistema
401 (conta) Conta inativa, cadastro incompleto ou sem assinatura Regularizar a conta no painel
429 Limite imposto pela sua infraestrutura Aplicar backoff e repetir (ver Limitação)
Nunca exponha o token no navegador
Chamadas com token devem sair do seu servidor. Em front-end, use o seu próprio backend como intermediário.

Boas práticas

  • Guarde o token em variável de ambiente ou cofre de segredos — nunca no repositório.
  • Não compartilhe token entre pessoas: um token por integração facilita revogar sem afetar outras.
  • Se o token vazar, gere outro imediatamente; o antigo morre na hora.
  • Registre no seu log qual token foi usado (um identificador, nunca o valor).

Verificação rápida

Exemplo em linha de comandobash
curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  https://api.hubiss.com.br/v1/stores

200 = token válido. 401 = gere outro.

Próximo passo
Siga para o Fluxo completo de integração e crie a primeira loja.