Tutoriales en vídeo
El vídeo está en inglés (narración y subtítulos).
Una clave API es una credencial en tu cuenta de ImageToTable.ai. Permite que una herramienta externa actúe como tu cuenta: el Complemento de Google Sheets puede conectarse con ella en lugar de iniciar sesión, y la API v1 la usa en cada llamada. Esta página cubre dónde se encuentra la clave, cómo reemplazarla y qué actualizar una vez que lo hagas.
Dónde encontrar tu clave API
La clave está en tu página de Perfil, en una sección titulada Clave API. Para llegar allí, abre el menú de cuenta en la esquina superior derecha de la aplicación — el que muestra tu avatar y nombre de usuario — y elige Perfil.
Esa sección muestra todo lo que la clave necesita:
- La clave en sí, oculta detrás de puntos por defecto. Usa el botón del ojo para revelarla y el botón Copiar para copiarla.
- Un botón que dice Regenerar clave API cuando ya existe una clave, o Generar clave API cuando aún no hay ninguna (la sección muestra Aún no hay clave API en ese caso).
- Una nota breve que indica que la clave es para herramientas externas, con un recordatorio de mantenerla en secreto, además de un enlace a la documentación de la API.
Trata la clave como una contraseña. Pertenece a la cuenta y no a una herramienta específica, por lo que el mismo valor funciona en cualquier lugar donde se acepte una clave — y cualquiera que la tenga puede actuar como tu cuenta. Esa es la razón por la que la sección te indica mantenerla en secreto.
Regeneración de su clave API
Una cuenta posee una única clave API. Regenerar reemplaza ese valor en lugar de añadir una segunda clave, por lo que nunca hay más de una clave activa. El paso de confirmación depende de cómo inicia sesión su cuenta, porque una cuenta creada con el inicio de sesión de Google no tiene una contraseña que usted conocería para escribir aquí.
Si su cuenta inicia sesión con una contraseña
Al elegir Regenerar clave API se abre un aviso de contraseña. Cuando ya existe una clave, el aviso indica que la clave actual será invalidada antes de solicitar su contraseña; cuando aún no hay clave, solicita su contraseña para crear una. Ingrese la contraseña de su cuenta y confirme para finalizar.
Si la contraseña no coincide, nada cambia y la página informa que la contraseña fue incorrecta.
Si su cuenta está vinculada al inicio de sesión de Google
Para una cuenta que inicia sesión con Google, la confirmación es un paso de inicio de sesión de Google en lugar de una contraseña. Al elegir Regenerar clave API se abre un diálogo titulado Confirme su identidad, que le solicita confirmar a través de Google. Si la cuenta ya tiene una clave, el diálogo indica que la clave actual será invalidada primero.
Este es el camino a utilizar cuando el aviso de contraseña anterior no es una opción para usted, que es el caso de las cuentas creadas mediante el inicio de sesión de Google.
Después de regenerar: actualice los lugares que usan la clave
Generar una nueva clave tiene efecto inmediato. El valor anterior deja de funcionar en ese momento: no hay período de gracia ni forma de mantener ambas claves activas. Cualquier cosa que aún envíe la clave antigua será rechazada hasta que se le proporcione la nueva.
| Dónde se usa la clave | Qué hacer después de regenerar |
|---|---|
| Complemento de Google Sheets | Abra la sección Cuenta en la barra lateral y pegue la nueva clave en el cuadro Pegar clave API. Si el complemento está conectado con Iniciar sesión con Google en su lugar, no usa la clave en absoluto y no necesita cambios. |
| API v1 | Reemplace la clave antigua por la nueva en todos los lugares donde su aplicación la almacena. Las llamadas realizadas con la clave antigua ya no se autentican, así que actualice la clave antes de su próxima ejecución. |
Regenerar cambia solo la clave. Sus archivos, plantillas, créditos, y plan no se modifican, y la nueva clave tiene el mismo acceso que la anterior.
Preguntas frecuentes
Perdí mi clave. ¿Puedo volver a verla?
Sí, siempre que pueda iniciar sesión. La página Perfil siempre muestra la clave actual; está oculta tras puntos hasta que la revela con el botón del ojo, y puede copiarla desde allí. Si prefiere reemplazarla a reutilizarla, use Regenerar clave API.
¿Puedo tener más de una clave a la vez?
No. La cuenta tiene una sola API Key. Regenerarla la reemplaza, por lo que el valor anterior deja de funcionar en cuanto se genera la nueva.
¿El complemento de Google Sheets siempre necesita una clave?
No. El complemento puede conectarse iniciando sesión con Google o pegando una API Key. Si lo conecta con el inicio de sesión de Google, la barra lateral no usa la clave, y regenerar una clave no afecta esa conexión. Solo los lugares que usan la clave en sí necesitan actualizarse. Consulte Complemento de Google Sheets.
¿La API v1 usa esta clave?
Sí. Cada llamada a la API v1 se autentica con la clave, por eso la anterior debe reemplazarse después de regenerarla. Acceso a la API explica para quién es la API y qué requiere; la referencia completa está en el sitio de documentación para desarrolladores.