Pular para o Conteúdo

Manual · UniFi

Chave de API do UniFi

Com a chave de API da sua conta UniFi, o Alpha HotSpot fala com o console pela nuvem da Ubiquiti: sem DDNS, sem abrir porta e funcionando até sem IP público. Leva uns 3 minutos.

Vídeo

1. Antes de Começar

  • Um console UniFi com UniFi OS 5.0.3 ou mais novo (UDM, UDR, UCG, Cloud Key ou UniFi OS Server), ligado à internet e aparecendo em unifi.ui.com.
  • O acesso à conta dona do console (a que aparece como Owner). Uma conta convidada ou só administradora de um site pode não enxergar o console pela API.
  • Um computador. A tela de chaves de API não aparece no aplicativo do celular.

2. Criar a Chave no Site da UniFi

  1. Entre em unifi.ui.com com a conta dona do console.
  2. Abra Settings e depois API Keys. O endereço direto é unifi.ui.com/settings/api-keys.
  3. Clique em Create New API Key e dê um nome fácil de reconhecer, por exemplo Alpha HotSpot.
  4. Copie a chave na hora. A Ubiquiti mostra a chave uma vez só. Se fechar a janela sem copiar, apague essa e crie outra.

A tela de chaves não fica dentro do aplicativo Network do console. Se você está vendo WiFi, Redes, Internet, VPN e Sistema no menu, está dentro do Network. Volte para a página inicial do unifi.ui.com (a lista dos seus consoles) ou abra direto unifi.ui.com/settings/api-keys.

Não use a chave de Integrações. Dentro do UniFi Network existe outra tela de chaves (Settings → Control Plane → Integrations). Essa chave é local: só funciona dentro da rede da loja e a Ubiquiti recusa pela nuvem com a mensagem "unauthorized".

3. Colar a Chave no Alpha HotSpot

  1. No painel, abra Wi‑Fi › MikroTik e UniFi, aba UniFi, e clique em Adicionar UniFi.
  2. No passo 1, escolha Pela conta UniFi, dê um nome e escolha a unidade.
  3. No passo 2, cole a chave em Chave de API do UniFi e clique em Buscar meus equipamentos.
  4. Escolha o seu console na lista e siga o assistente: site, Wi‑Fi de visitantes, portal e teste.

Depois de conectado, o assistente Configurar o UniFi e a tela Nova rede Wi‑Fi do painel usam essa mesma chave para criar a VLAN, o Wi‑Fi e o portal no console.

4. Histórico de Tentativas

Logo abaixo do botão Buscar meus equipamentos aparece o quadro Tentativas com a chave. Cada tentativa mostra a data e a hora, quem tentou, os quatro últimos caracteres da chave, se ela foi aceita e, quando recusada, o que a Ubiquiti respondeu. A chave inteira nunca aparece.

5. Problemas Comuns

  • "A Ubiquiti não aceitou essa chave" (unauthorized): a chave é a das Integrações (local), foi copiada pela metade ou foi apagada em unifi.ui.com. Crie uma nova em Settings → API Keys e cole de novo.
  • "Essa conta não é administradora do console": a chave foi criada em outra conta. Veja em unifi.ui.com qual e-mail é o dono do console e crie a chave com ele.
  • Nenhum console encontrado: o console não está ligado a essa conta. Em unifi.ui.com, confira se ele aparece na lista de equipamentos.
  • Console aparece desconectado: o console está sem internet ou com o acesso remoto desligado. Ligue o acesso remoto no UniFi OS e atualize para 5.0.3 ou mais novo.
  • Muitas consultas (código 429): aguarde um minuto e tente de novo.

6. Segurança

  • A chave fica guardada criptografada no Alpha HotSpot e não aparece de novo na tela.
  • Não envie a chave por e-mail, WhatsApp ou chat. Cole direto no painel.
  • Para cortar o acesso, apague a chave em unifi.ui.com › Settings › API Keys. Para trocar, crie outra e cole no passo 2 do assistente.

Pronto para Configurar?

Crie sua conta: o painel gera a configuração com os dados reais da sua rede.

Começar GrátisFalar com Especialista