Skip to main content
Cada software que você deseja proteger com o Bluube precisa de uma aplicação registrada. Ela agrupa todas as licenças, configurações e credenciais de API do seu produto.
Use nomes de aplicação consistentes e descritivos, como meu-app-desktop-v2 ou plugin-photoshop-pro. Evite espaços e caracteres especiais — prefira letras minúsculas, números e hífens. Isso facilita identificar a aplicação ao depurar chamadas de API nos logs.

​
Criar sua primeira aplicação

1

Acesse o dashboard

Abra app.bluube.com e faça login com suas credenciais. Você será direcionado à tela inicial com a lista de suas aplicações.
2

Navegue até Nova Aplicação

No menu lateral esquerdo, clique em Aplicações e depois em Nova Aplicação no canto superior direito da página.
3

Preencha os dados da aplicação

No formulário de criação, informe:
  • Nome: nome do seu software, conforme a convenção recomendada acima.
  • Descrição: breve resumo do que o software faz. Esse campo é apenas para controle interno.
Clique em Criar Aplicação para confirmar.
4

Copie o app_id e o api_key

Após a criação, o Bluube exibe as credenciais geradas para a aplicação:
resposta de criação
{
  "app_id": "app_01j9k2m3n4p5q6r7s8t9",
  "api_key": "blv1_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "name": "meu-app-desktop",
  "description": "Meu software de edição de vídeo",
  "created_at": "2026-04-06T12:00:00Z"
}
Copie ambos os valores imediatamente — o api_key não será exibido novamente após você fechar essa tela.
5

Armazene o api_key com segurança

Nunca exponha seu api_key em repositórios de código, arquivos de configuração versionados ou logs de aplicação. Qualquer pessoa com acesso a essa chave pode criar, validar e revogar licenças da sua aplicação. Armazene-a em um gerenciador de segredos (como AWS Secrets Manager, HashiCorp Vault ou variáveis de ambiente do sistema operacional).
Em desenvolvimento local, use um arquivo .env e adicione-o ao .gitignore:
.env
BLUUBE_APP_ID=app_01j9k2m3n4p5q6r7s8t9
BLUUBE_API_KEY=blv1_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
6

Teste a conexão com a API

Verifique se as credenciais estão funcionando com uma chamada simples ao endpoint de status da aplicação:
curl
curl --request GET \
  --url https://api.bluube.com/v1/apps/app_01j9k2m3n4p5q6r7s8t9 \
  --header "Authorization: Bearer blv1_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Uma resposta bem-sucedida confirma que a aplicação foi criada corretamente e que suas credenciais estão válidas:
resposta de sucesso
{
  "app_id": "app_01j9k2m3n4p5q6r7s8t9",
  "name": "meu-app-desktop",
  "description": "Meu software de edição de vídeo",
  "status": "active",
  "licenses_count": 0,
  "created_at": "2026-04-06T12:00:00Z"
}
Se receber um erro 401 Unauthorized, verifique se o api_key foi copiado corretamente e se o cabeçalho Authorization está no formato Bearer <api_key>.

​
Próximos passos

Com a aplicação criada, você já pode começar a emitir licenças para os seus usuários. Consulte Gerenciar Licenças para aprender a criar e administrar licenças pela dashboard e via API.