--- title: "API Pública da Hubla: crie e use tokens de API" description: Saiba como criar um token de API Pública na Hubla, autenticar as chamadas, conhecer os limites e o que dá para fazer pela API. --- [Pular para o conteúdo](https://help.hub.la/hc/pt-br/api-publica#main-content) [![logo-hubla-ajustado\_1](https://help.hub.la/hs-fs/hubfs/logo-hubla-ajustado_1.png?width=185&height=43&name=logo-hubla-ajustado_1.png)](https://help.hub.la/?hsLang=pt-br) - [Central de Ajuda](https://help.hub.la/hc/pt-br) Abrir navegação principal Fechar navegação principal - [Central de Ajuda](https://help.hub.la/hc/pt-br) - [Acesse sua Conta](https://app.hub.la/auth) [Acesse sua Conta](https://app.hub.la/auth) Como podemos ajudar? - Não há sugestões porque o campo de pesquisa está em branco. 1. [Ajuda | Hubla](https://help.hub.la/hc/pt-br?hsLang=pt-br) 2. [Vendo ou quero vender um produto](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br) 3. [Integrações](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#integra%C3%A7%C3%B5es) # API Pública da Hubla: crie e use tokens de API ## Conecte o seu sistema à Hubla para consultar e alterar dados da sua conta. A **API pública da Hubla** permite que o seu próprio sistema (um ERP, um CRM, um painel interno) consulte e altere dados da sua conta: produtos, ofertas, faturas, assinaturas, cupons, membros e mais. Para isso, você cria um **token de API**, a chave que autentica as chamadas do seu sistema. **Bom saber:** usar a API exige alguém com conhecimento técnico, como um desenvolvedor ou a sua equipe de TI. Se você só quer conectar uma ferramenta pronta, veja as [integrações nativas](https://help.hub.la/hc/pt-br/integracoes-nativas?hsLang=pt-br). ## API, webhook ou MCP: qual usar? | Ferramenta | Direção | Quando usar | | --- | --- | --- | | **[Webhook](https://help.hub.la/hc/pt-br/webhook-hubla?hsLang=pt-br)** | Hubla → seu sistema | Para ser avisado automaticamente quando algo acontece, como uma venda aprovada ou um reembolso. | | **API pública** | Seu sistema → Hubla | Para consultar ou alterar dados da sua conta quando o seu sistema precisar. | | **[Hubla MCP](https://help.hub.la/hc/pt-br/hubla-mcp?hsLang=pt-br)** | Assistente de IA → Hubla | Para consultar e operar a sua conta conversando com um assistente de IA. | Webhook e API costumam ser usados juntos: o webhook avisa que uma venda aconteceu e o seu sistema usa a API para buscar mais detalhes ou fazer uma ação em seguida. ## Como criar um token 1 No menu lateral, clique em **Integrações** e depois em **Criar nova integração**.![Tela de Integrações com o botão Criar nova integração](https://help.hub.la/hubfs/FAQ/api-publica/api-publica-01-integracoes.png) 2 Em **Ferramentas de Integração e Automação**, clique em **Configurar** na linha **Tokens de API Pública**.![Lista de ferramentas com Tokens de API Pública em destaque](https://help.hub.la/hubfs/FAQ/api-publica/api-publica-02-criar-integracao.png) 3 Abra a aba **Tokens de API** e clique em **Criar token**.![Aba Tokens de API com o botão Criar token](https://help.hub.la/hubfs/FAQ/api-publica/api-publica-03-tela-de-tokens.png) 4 Dê um **Apelido** ao token (opcional) e clique em **Criar token**. Use o nome do sistema que vai usar a chave, e não o de uma pessoa, por exemplo: *ERP financeiro*.![Janela Criar token de API com o campo Apelido](https://help.hub.la/hubfs/FAQ/api-publica/api-publica-04-apelido.png) 5 Clique em **Copiar token**, guarde a chave em um local seguro (como um gerenciador de senhas ou as variáveis de ambiente do seu sistema) e só depois clique em **Já copiei a chave**.![Janela Copie a chave agora com a chave oculta](https://help.hub.la/hubfs/FAQ/api-publica/api-publica-05-copiar-chave.png) **Importante:** a chave aparece **uma única vez**. Se você fechar a janela sem copiar, não há como recuperá-la, nem pelo suporte: é preciso criar outro token. Trate a chave como uma senha e não envie por e-mail nem por mensagem. ## Gerenciar seus tokens Até 5 tokens ativos Crie um token por sistema. Assim você revoga o acesso de um sem derrubar os outros. Revogar um token Na aba **Tokens de API**, revogue o token que não for mais usado ou que possa ter vazado. O efeito é imediato: as próximas chamadas com essa chave são recusadas. Trocar sem interrupção Crie o token novo, atualize a chave no seu sistema e só depois revogue o antigo. Perdeu a chave? Não dá para ver a chave de novo. Crie um novo token, atualize o seu sistema e revogue o antigo. ## Como autenticar as chamadas Envie a chave no cabeçalho **Authorization** de cada requisição, **sem** o prefixo *Bearer*. Para testar, uma boa primeira chamada é a listagem de produtos: ``` POST https://backend-bff-public-api.platform.hub.la/v1/products/list Authorization: SUA_CHAVE ``` ✓ Sem “Bearer” Envie só a chave no cabeçalho. Com o prefixo Bearer, a chamada retorna erro 401. ✓ Listagens usam POST As rotas de listagem recebem os filtros no corpo da requisição. ✓ Todo 2xx é sucesso Algumas rotas retornam 201 em vez de 200. Trate qualquer resposta 2xx como sucesso. ✓ Não existe sandbox Teste com rotas de leitura ou com um produto de teste antes de alterar dados reais. ✓ Chave só no servidor Nunca coloque a chave em código que roda no navegador ou no app do cliente. ✓ Um token por sistema Facilita identificar e revogar o acesso de cada integração. ## Limites de requisições 100 por minuto Por produtor, nas rotas de produtos, ofertas e cupons. Limite por rota As demais rotas têm limites próprios, descritos na documentação técnica. 300 por minuto por IP Para chamadas sem uma chave válida. Erro 429 O limite foi atingido. Aguarde o tempo indicado no cabeçalho **Retry-After** e tente de novo. ## O que dá para fazer pela API | Recurso | Operações | | --- | --- | | **Produtos** | Listar, buscar, criar, editar e excluir | | **Ofertas** | Listar e buscar por produto, criar, editar e excluir | | **Faturas** | Listar e buscar | | **Assinaturas** | Buscar, criar assinatura gratuita, desativar, desativar a renovação automática e adicionar créditos | | **Cupons** | Listar, buscar, criar, ativar, desativar e excluir | | **Membros** | Listar por produto, convidar e cancelar convite | | **Participantes** | Listar por produto | | **Reembolsos** | Listar, aceitar e rejeitar | | **Leads** | Listar, buscar e criar | | **Parcelamento inteligente** | Listar, buscar e listar faturas | ## Problemas comuns - **Erro 401 mesmo com a chave certa.** Confira se a chave não está com o prefixo Bearer ou com espaços extras, e se o token não foi revogado. - **Erro 404 em um registro que existe.** O registro provavelmente pertence a outra conta. Cada token só acessa os dados da conta em que foi criado. - **Erro 429 com poucas requisições.** Normalmente há um erro 401 por trás: chamadas sem chave válida entram no limite de 300 por minuto por IP. Corrija a autenticação primeiro. - **Erro ao desativar uma assinatura em período de teste.** A rota de desativar não funciona para assinaturas em teste. Para cancelar, use a rota de desativar a renovação automática ([`PATCH /v1/subscriptions/{id}/disable-auto-renew`](https://backend-bff-public-api.platform.hub.la/swagger/v1#tag/subscription/PATCH/v1/subscriptions/%7Bid%7D/disable-auto-renew)). Hoje não é possível encerrar o teste e cobrar na hora na mesma assinatura. - **Como identificar o erro?** As respostas de erro trazem o campo `errorCode`, por exemplo `invalid-api-token` (401), `rate-limit-exceeded` (429) e `product-not-found` (404). ## Documentação técnica Para a sua equipe técnica, a lista completa de rotas, parâmetros e respostas está no [Swagger da API pública](https://backend-bff-public-api.platform.hub.la/swagger/v1) e na [documentação para desenvolvedores](https://hubla.gitbook.io/docs/api-publica/introducao). ## Ficou alguma dúvida? [Fale com o nosso suporte](https://wa.me/5511945247442) e a gente te ajuda! 💚 - [Comprei ou quero comprar um produto](https://help.hub.la/hc/pt-br/comprei-ou-quero-comprar-um-produto?hsLang=pt-br#main-content) - [Acesso](https://help.hub.la/hc/pt-br/comprei-ou-quero-comprar-um-produto?hsLang=pt-br#acesso) - [Reembolso](https://help.hub.la/hc/pt-br/comprei-ou-quero-comprar-um-produto?hsLang=pt-br#reembolso) - [Assinatura](https://help.hub.la/hc/pt-br/comprei-ou-quero-comprar-um-produto?hsLang=pt-br#assinatura) - [Conta](https://help.hub.la/hc/pt-br/comprei-ou-quero-comprar-um-produto?hsLang=pt-br#conta) - [Dúvidas frequentes](https://help.hub.la/hc/pt-br/comprei-ou-quero-comprar-um-produto?hsLang=pt-br#d%C3%BAvidas-frequentes) - [Aplicativo para membros](https://help.hub.la/hc/pt-br/comprei-ou-quero-comprar-um-produto?hsLang=pt-br#aplicativo-para-membros) - [Vendo ou quero vender um produto](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#main-content) - [Conheça a Hubla](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#conhe%C3%A7a-a-hubla) - [Gestão de Produtos](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#gest%C3%A3o-de-produtos) - [Financeiro](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#financeiro) - [Conta](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#conta) - [Assinaturas](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#assinaturas) - [Integrações](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#integra%C3%A7%C3%B5es) - [Relatórios](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#relat%C3%B3rios) - [Área de Membros](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#%C3%A1rea-de-membros) - [Gestão de Grupos](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#gest%C3%A3o-de-grupos) - [Ofertas e preços](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#ofertas-e-pre%C3%A7os) - [Afiliados](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#afiliados) - [Reembolso](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#reembolso) - [Aplicativo para alunos](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#aplicativo-para-alunos) - [Hubla Agents](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-um-produto?hsLang=pt-br#hubla-agents) - [Vendo ou quero vender como afiliado](https://help.hub.la/hc/pt-br/vendo-ou-quero-vender-como-afiliado?hsLang=pt-br) [![Contato Hubla](https://help.hub.la/hs-fs/hubfs/c%C3%B3pia%20de%20WhatsApp%20Image%202023-05-25%20at%2018.jpg?width=130&height=48&name=c%C3%B3pia%20de%20WhatsApp%20Image%202023-05-25%20at%2018.jpg "Contato Hubla")](https://wa.me/5511945247442)