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
- Entre no painel da Hubiss.
- Clique no ícone do usuário (canto superior direito).
- Escolha Token API.
- 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.