Ir para o conteúdo

Tokens de API e a licença sandbox

81 visualizações · Atualizado Nov 22, 2026

Os autores contam com duas ferramentas para incorporar verificações de licença a um produto: Tokens de API, que autenticam requisições à API da AppTrovo em nome da sua conta, e licenças de teste para desenvolvedores gratuitas, que permitem executar todo o fluxo de verificação de licença na sua própria máquina antes que qualquer comprador tenha uma chave.

Tokens de API

Quando você precisa de um token

O endpoint de verificação de licenças (/api/v1/licenses/verify) é público. Seu produto não precisa de token para validar a chave de um comprador. Os tokens servem para as partes autenticadas da API, como listar as licenças que sua conta possui (/api/v1/licenses) ou ler seus próprios dados de autor em /api/v2/author/.

Um token age em nome da sua conta. Nunca coloque um token em um produto que você vende, em um repositório público ou em código executado no navegador. Qualquer pessoa que o tenha pode fazer chamadas à API como se fosse você.

Crie um token

  1. Acesse /author/api-tokens com sua conta de autor conectada.
  2. Em Criar novo token, informe um Nome do token que indique onde ele será usado, por exemplo "Servidor de build".
  3. Clique em Criar token.
  4. Copie o token do quadro verde imediatamente. Ele não será exibido novamente. Clique em Descartar depois de guardá-lo em um lugar seguro.
Página Tokens de API com um campo Nome do token e um botão Criar token, uma seção Os seus tokens com a mensagem Nenhum token API criado ainda e um quadro Utilização da API com um exemplo de requisição de verificação e cabeçalhos
A página Tokens de API no Painel do autor.

Envie o token no cabeçalho Authorization: Bearer , junto com Accept: application/json.

Gerencie e revogue tokens

Seus tokens lista cada token com o nome, a data de criação e a data do último uso, ou "Nunca usado". Você pode ter até 10 tokens ao mesmo tempo. Os tokens não expiram sozinhos, então revogue os que não precisar mais: clique em Revogar e confirme. Um token revogado deixa de funcionar imediatamente. Se um token puder ter vazado, revogue-o e crie um novo.

A licença sandbox do SDK

A sandbox permite testar a verificação de licenças antes mesmo de você criar um produto. Ela fornece uma chave de desenvolvedor para um produto sandbox compartilhado cujo slug é apptrovo-sdk-sandbox.

  1. Abra /author/sandbox-license. Se você ainda não tiver produtos, o painel de autor também mostra um botão Obter licença sandbox.
  2. Clique em Gerar. Sua chave aparece com um botão de copiar, a data de expiração, os espaços de domínio em uso e o slug do produto.
  3. Copie os comandos de Teste rápido de funcionamento exibidos abaixo da chave. O primeiro, que usa domain=localhost, deve retornar "valid": true. O segundo, que usa um domínio público, precisa ser recusado.
  4. Configure seu instalador com o slug da sandbox e execute seus cenários de verificação.
Página Licença sandbox do SDK com um cartão A sua licença de programador sandbox listando os domínios locais permitidos e um botão Gerar, seguido de um aviso amarelo sobre o lançamento do seu próprio produto e um link de volta ao Guia de integração de licença
Gere uma chave sandbox na página Licença sandbox do SDK.

Licenças de desenvolvedor para seus próprios produtos

Depois que você tiver um produto, teste diretamente com ele:

  1. Abra Meus produtos e clique no produto para abrir a página de detalhes.
  2. Encontre o cartão Licença de teste de desenvolvedor e clique em Gerar.
  3. Copie a chave e o slug do produto exibidos no cartão e use o comando de Teste rápido para confirmar que tudo funciona.

Na hora de lançar, troque o slug da sandbox na configuração do instalador pelo slug real do seu produto. O restante da integração continua igual.

Regras das licenças de desenvolvedor

As licenças sandbox e as licenças de desenvolvedor por produto funcionam da mesma forma:

  • Elas só são validadas em hostnames locais: localhost, 127.0.0.1, ::1 e nomes terminados em .test, .local ou .localhost. Um domínio real é recusado, então a chave não pode ser usada em produção.
  • Toda verificação precisa incluir o parâmetro domain.
  • Cada chave tem 5 espaços de domínio e vale por 30 dias. Clique em Estender por 30 dias no mesmo cartão para adiar a expiração. A chave continua a mesma.
  • Você recebe uma licença de desenvolvedor por produto. Gerar novamente prolonga a chave existente em vez de criar uma nova.
  • A resposta da verificação informa "license_type": "developer" e "is_dev": true, para que seu código consiga diferenciar as chaves de teste.

Perguntas frequentes

Por que não vejo Tokens de API na barra lateral?

No momento, a página não tem um item de menu. Salve /author/api-tokens nos favoritos.

Minha chave de desenvolvedor diz "License has expired"

Abra o cartão em que você a criou e clique em Estender por 30 dias. A mesma chave volta a funcionar.

Artigos relacionados

Este artigo foi útil?