API key
Una API key es una cadena secreta que demuestra que otro sistema tiene permiso para leer tus datos. Funciona como una contraseña, salvo que la proporciona un programa en lugar de una persona, y sigue siendo válida hasta que la revoques.
Dato útil: el editor y la cuenta de Gatherino están disponibles en inglés o checo. Los formularios que rellenan quienes responden pueden mostrarse en 18 idiomas, incluido el español.
La clave se crea en los ajustes y se muestra una sola vez. Guárdala de inmediato en una variable de entorno o en un gestor de secretos de tu servidor; no podrás volver a consultarla, porque se almacena de forma que no es posible recuperar el valor original.
El error más habitual es poner la clave en el JavaScript de la página. El código del navegador es público: cualquiera puede copiar la clave y descargar todas las respuestas de todos tus formularios. Por eso las llamadas a la API deben hacerse desde un servidor que guarde la clave y devuelva solo lo que está pensado para ser público.
Si una clave se filtra, no investigues si alguien la ha usado: revócala y emite una nueva. La revocación es inmediata y la clave antigua deja de funcionar.
En la práctica
- La clave debe estar en una variable de entorno del servidor, no en un repositorio ni en el frontend.
- Usa una clave independiente para cada integración, así podrás revocar solo la que corresponda.
- Rota la clave cuando salga de la organización alguien que la conocía.
Preguntas frecuentes
¿Dónde creo una API key?
En Ajustes → API keys. Solo se muestra una vez.
¿Cómo se envía la clave?
En una cabecera Authorization: Bearer <key> o en una cabecera x-api-key.
¿Qué pasa cuando revoco una clave?
Deja de funcionar de inmediato y las integraciones que la usen recibirán un 401.
Relacionados
Prueba Gatherino gratis
Plan gratuito: 3 formularios y 100 respuestas al mes. Sin tarjeta de crédito. Datos alojados en la UE.
Empieza gratis →