Tutoriais em vídeo
O vídeo está em inglês (narração e legendas).
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 aborda onde a chave fica, como substituí-la e o que atualizar depois de fazer isso.
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 Ainda não há chave de API 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, e não a qualquer 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 você 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 login do Google não tem uma senha que você conheceria para digitar aqui.
Se sua conta faz login com senha
Escolher Regenerar chave de API abre um prompt de senha. Quando uma chave já existe, o prompt indica que a chave atual será invalidada antes de pedir sua senha; quando ainda não há chave, ele pede sua senha para criar uma. Insira a senha da sua conta e confirme para finalizar.
Se a senha não corresponde, 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 Google, a confirmação é uma etapa de login do Google em vez de uma senha. Escolher Regenerar chave de API abre um diálogo intitulado Confirme sua identidade, que pede que você confirme através do Google. Se a conta já tem uma chave, o diálogo indica 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 para contas criadas através do login do Google.
Depois de regenerar: atualize os lugares que usam a chave
Gerar uma nova chave entra em vigor imediatamente. O valor anterior deixa de funcionar nesse momento — não há período de carência e nenhuma forma de manter ambas chaves ativas. Qualquer coisa que ainda envie a chave antiga é recusada até que receba a nova.
| Onde a chave é usada | O que fazer depois de 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 está conectado com Entrar com Google em vez disso, ele não usa a chave de API de jeito algum e não precisa de nenhuna mudança. |
| API v1 | Substitua a chave antiga pela nova em todos os lugares onde sua aplicação a armazena. Chamadas feitas com a chave antiga não são mais autenticadas, então atualize a chave antes da sua próxima execução. |
Regenerar muda apenas a chave. Seus arquivos, modelos, créditos, e plano não são alterados, e a nova chave carrega 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 ao mesmo tempo?
Não. A conta possui uma única API Key. Regenerar a substitui, então o valor anterior para de funcionar assim que a nova for 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ê conectá-lo 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. Consulte 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.