Tokens de API e a licença sandbox
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
- Acesse /author/api-tokens com sua conta de autor conectada.
- Em Criar novo token, informe um Nome do token que indique onde ele será usado, por exemplo "Servidor de build".
- Clique em Criar token.
- Copie o token do quadro verde imediatamente. Ele não será exibido novamente. Clique em Descartar depois de guardá-lo em um lugar seguro.

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.
- 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.
- 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.
- 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. - Configure seu instalador com o slug da sandbox e execute seus cenários de verificação.

Licenças de desenvolvedor para seus próprios produtos
Depois que você tiver um produto, teste diretamente com ele:
- Abra Meus produtos e clique no produto para abrir a página de detalhes.
- Encontre o cartão Licença de teste de desenvolvedor e clique em Gerar.
- 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,::1e nomes terminados em.test,.localou.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?