Claves API
Una clave API permite que otro sistema de tu empresa —un ERP, un cuadro de mando, un script— lea o escriba en goPrevina a través de la API REST, sin usar la cuenta de ninguna persona. Todas las llamadas van a la ruta base /api/v1.
Estas guías se publican de momento en castellano. Dentro de la aplicación, la misma ayuda está en castellano, catalán, gallego, euskera, inglés y francés.
1. Qué hay en la pantalla
Arriba, el bloque «Crear una clave» con el campo «Nombre», los «Ámbitos» («Lectura» y «Escritura») y el botón «Crear una clave». Debajo, la lista de claves de la empresa; si no hay ninguna, dice «Aún no hay claves API.».
2. Crear una clave
1. Escribe un «Nombre» que diga quién la usa (por ejemplo, “ERP de nóminas” o “cuadro de mando de dirección”).
2. Marca los «Ámbitos»: «Lectura» si el sistema solo consulta datos; añade «Escritura» solo si tiene que crear o modificar registros.
3. Pulsa «Crear una clave».
4. Aparece “Copia esta clave ahora — no se volverá a mostrar:”. Cópiala y guárdala en el sistema que la va a usar; después pulsa “Hecho”. Si la pierdes, tendrás que crear otra o rotarla.
3. Rotar, revocar y vigilar el uso
Cada clave de la lista muestra su nombre, sus ámbitos y su “último uso”. “Rotar” genera un valor nuevo para la misma clave (el anterior deja de valer) y lo enseña una sola vez. “Revocar” la anula de inmediato y no se puede deshacer: úsalo cuando un sistema deja de necesitarla o si sospechas que se ha filtrado. Las claves revocadas o caducadas aparecen marcadas como “revocada” o “caducada”.
El consumo de la API frente a la cuota de tu plan se ve en “Monitorización de integraciones”.
4. Una clave por sistema
Crea una clave distinta para cada sistema que se conecte: así, si uno se retira o se compromete, revocas solo la suya y los demás siguen funcionando, y en “último uso” sabes cuál está activo. La clave da acceso a los datos de toda la empresa con los ámbitos que le diste: guárdala en el gestor de secretos del sistema que la usa, nunca en un correo ni en una hoja de cálculo.