Claves API
Unha clave API permite que outro sistema da túa empresa —un ERP, un cadro de mando, un script— lea ou escriba en goPrevina a través da API REST, sen usar a conta de ningunha persoa. Todas as chamadas van á ruta base /api/v1.
1. Que hai na pantalla
Arriba, o bloque «Crear unha clave» co campo «Nome», os «Ámbitos» («Lectura» e «Escritura») e o botón «Crear unha clave». Debaixo, a lista de claves da empresa; se non hai ningunha, di «Aínda non hai claves API.».
2. Crear unha clave
1. Escribe un «Nome» que diga quen a usa (por exemplo, “ERP de nóminas” ou “cadro de mando de dirección”).
2. Marca os «Ámbitos»: «Lectura» se o sistema só consulta datos; engade «Escritura» só se ten que crear ou modificar rexistros.
3. Preme «Crear unha clave».
4. Aparece “Copia esta clave agora — non se mostrará de novo:”. Cópiaa e gárdaa no sistema que a vai usar; despois preme “Feito”. Se a perdes, terás que crear outra ou rotala.
3. Rotar, revogar e vixiar o uso
Cada clave da lista amosa o seu nome, os seus ámbitos e o seu “último uso”. “Rotar” xera un valor novo para a mesma clave (o anterior deixa de valer) e amósao unha soa vez. “Revogar” anúlaa de inmediato e non se pode desfacer: úsao cando un sistema deixa de necesitala ou se sospeitas que se filtrou. As claves revogadas ou caducadas aparecen marcadas como “revogada” ou “caducada”.
O consumo da API fronte á cota do teu plan vese en “Monitorización de integracións”.
4. Unha clave por sistema
Crea unha clave distinta para cada sistema que se conecte: así, se un se retira ou se compromete, revogas só a súa e os demais seguen funcionando, e en “último uso” sabes cal está activo. A clave dá acceso aos datos de toda a empresa cos ámbitos que lle deches: gárdaa no xestor de segredos do sistema que a usa, nunca nun correo nin nunha folla de cálculo.