Uma Chave de API é uma credencial na sua conta ImageToTable.ai. Ela permite que uma ferramenta externa atue como sua conta: o Complemento do Google Sheets pode se conectar com ela em vez de fazer login, e a API v1 a usa em cada chamada. Esta página cobre onde a chave fica, como substituí-la e o que atualizar depois.
Onde encontrar sua Chave de API
A chave está na sua página de Perfil, em uma seção intitulada Chave de API. Para chegar lá, abra o menu da conta no canto superior direito do aplicativo — o que tem seu avatar e nome de usuário — e escolha Perfil.
Essa seção mostra tudo o que a chave precisa:
- A própria chave, oculta atrás de pontos por padrão. Use o botão de olho para revelá-la e o botão Copiar para copiá-la.
- Um botão que mostra Regenerar chave de API quando uma chave já existe, ou Gerar chave de API quando ainda não há nenhuma (a seção mostra Nenhuma chave de API ainda nesse caso).
- Uma breve nota de que a chave é para ferramentas externas, com um lembrete para mantê-la em segredo, além de um link para a documentação da API.
Trate a chave como uma senha. Ela pertence à conta, não a uma ferramenta específica, então o mesmo valor funciona em qualquer lugar onde uma chave seja aceita — e qualquer pessoa que a tenha pode atuar como sua conta. É por isso que a seção diz para mantê-la em segredo.
Regenerando sua chave de API
Uma conta possui uma única chave de API. Regenerar substitui esse valor em vez de adicionar uma segunda chave, portanto nunca há mais de uma chave ativa. A etapa de confirmação depende de como sua conta faz login, porque uma conta criada com o login do Google não tem senha que você saberia digitar aqui.
Se sua conta faz login com senha
Ao escolher Regenerar chave de API, um prompt de senha é aberto. Quando uma chave já existe, o prompt informa que a chave atual será invalidada antes de pedir sua senha; quando ainda não há chave, ele pede sua senha para criar uma. Digite a senha da sua conta e confirme para concluir.
Se a senha não corresponder, nada muda e a página informa que a senha estava incorreta.
Se sua conta está vinculada ao login do Google
Para uma conta que faz login com o Google, a confirmação é uma etapa de login do Google em vez de senha. Ao escolher Regenerar chave de API, um diálogo intitulado Confirme sua identidade é aberto, pedindo que você confirme pelo Google. Se a conta já tiver uma chave, o diálogo informa que a chave atual será invalidada primeiro.
Este é o caminho a usar quando o prompt de senha acima não é uma opção para você, que é o caso de contas criadas pelo login do Google.
Após regenerar: atualize os locais que usam a chave
Gerar uma nova chave tem efeito imediato. O valor anterior para de funcionar nesse momento — não há período de carência nem como manter as duas chaves ativas. Qualquer coisa que ainda envie a chave antiga é recusada até receber a nova.
| Onde a chave é usada | O que fazer após regenerar |
|---|---|
| Complemento do Google Sheets | Abra a seção Conta na barra lateral e cole a nova chave na caixa Colar chave de API. Se o complemento estiver conectado com Entrar com o Google em vez disso, ele não usa a chave e não precisa de alteração. |
| API v1 | Substitua a chave antiga pela nova em todos os lugares onde seu aplicativo a armazena. Chamadas feitas com a chave antiga não são mais autenticadas, então atualize a chave antes da próxima execução. |
Regenerar altera apenas a chave. Seus arquivos, modelos, créditos e plano permanecem intactos, e a nova chave tem o mesmo acesso que a antiga.
Perguntas frequentes
Perdi minha chave. Posso consultá-la novamente?
Sim, desde que você consiga entrar. A página Perfil sempre mostra a chave atual; ela fica oculta atrás de pontos até você revelá-la com o botão de olho, e você pode copiá-la de lá. Se preferir substituí-la em vez de reutilizá-la, use Regenerar chave de API.
Posso ter mais de uma chave por vez?
Não. A conta possui uma única API Key. Regenerar substitui a chave, então o valor anterior para de funcionar assim que a nova é gerada.
O Complemento do Google Sheets sempre precisa de uma chave?
Não. O complemento pode se conectar entrando com o Google ou colando uma API Key. Se você conectar com o login do Google, a barra lateral não usa a chave, e regenerar uma chave não afeta essa conexão. Apenas os locais que usam a chave precisam ser atualizados. Veja Complemento do Google Sheets.
A API v1 usa esta chave?
Sim. Toda chamada da API v1 autentica com a chave, por isso a antiga precisa ser substituída após a regeneração. Acesso à API explica para quem a API é destinada e o que ela exige; a referência completa está no site de documentação para desenvolvedores.