Chaves pessoais

Uma chave pessoal dá acesso à sua própria conta, sem tela de autorização. Serve para scripts, planilhas, automações e para usar o HotLearn num assistente de IA no seu computador.

Trate a chave como uma senha. Quem tiver a chave consegue fazer o que ela permite, até ela vencer ou ser revogada.

Criar#

1. Entre no HotLearn como dono da conta.
2. Abra Integrações no menu e vá até Chaves pessoais.
3. Dê um nome (ex.: "Assistente no notebook"), marque o que a chave pode fazer e escolha a validade (30, 90 ou 365 dias).
4. Copie a chave. Ela aparece uma única vez: o HotLearn guarda só uma marca dela, não a chave.

Usar#

curl https://hotlearn.com.br/api/v1/me \
  -H "Authorization: Bearer $HOTLEARN_KEY"

O que muda em relação a um aplicativo autorizado:

• a chave age como o dono que a criou;
• não há renovação: perto de vencer, crie outra;
• ela não tem conexão. GET /connection responde 404 com code = no_connection.

O que uma chave pessoal pode fazer#

Uma chave pessoal pode receber estes escopos:

• account:read: ver o plano e o saldo de créditos;
• catalog:read: ver o acervo e a sua biblioteca;
• acquisitions:read e acquisitions:write: ver e fazer aquisições;
• materials:read: ler e baixar os seus materiais;
• publications:read: ver as publicações dos seus materiais.

Escopos de aplicativo (como connection:write e login_links:write) não existem na chave pessoal. Detalhes em Escopos.

Revogar#

Em Integrações › Chaves pessoais, clique em Revogar. A chave para na hora. A lista mostra quando cada chave foi usada pela última vez: chave parada há muito tempo é candidata a revogar.

Assistentes de IA (MCP)#

O servidor MCP do HotLearn (para Claude e outros assistentes) está nos planos. Quando chegar, ele vai aceitar a chave pessoal e o login pelo OAuth, e esta página vai trazer o passo a passo.