Habilitación y keys

Habilitar el módulo

La API es un módulo opcional y viene apagada en todas las cuentas. Safety Panel la activa desde el panel de administración (Cuentas → ficha de la cuenta → Funcionalidades → Habilitar API). Para pedirlo, contactá a tu representante de Safety Panel.

Con el módulo apagado:

• La opción API no aparece en Configuración.
• Las keys que ya existan siguen guardadas, pero toda llamada con ellas responde 403 con el código module_disabled (ver errores).

Cuando el módulo se vuelve a habilitar, las keys vigentes vuelven a funcionar sin tener que emitir otras.

Emitir una key

Solo un administrador de la cuenta puede gestionar las keys. El rol de acceso limitado no las ve, porque una key lee más de lo que ese rol puede ver en el panel.

1. Ingresá al panel administrativo y andá a Configuración → API.
2. Tocá Nueva key.
3. Poné un nombre que diga qué sistema la va a usar (por ejemplo, «Plataforma de protocolos») y confirmá con Crear key.
4. Copiá la key que aparece arriba de la lista con Copiar key y guardala en el sistema que la va a usar.

La key se muestra una sola vez

Safety Panel no guarda la key, solo una huella que permite reconocerla. Si se pierde, no se puede recuperar: revocala y emití otra.

Todas las keys empiezan con spk_, así es fácil reconocerlas en la configuración de otro sistema o en un registro.

Conviene emitir una key por sistema. Así, cuando uno cambia o deja de usarse, se revoca solo la suya.

La lista de keys

Configuración → API muestra todas las keys de la cuenta, las vigentes y las revocadas:

Columna	Qué muestra
Nombre	El nombre que se le puso y quién la emitió.
Estado	Vigente o Revocada.
Creada	Cuándo se emitió.
Último uso	Cuándo se usó por última vez y desde qué dirección IP, o «Nunca se usó». Se actualiza como mucho cada cinco minutos.

La página también muestra la dirección base de la API de la cuenta, la que el sistema externo tiene que usar.

Revocar una key

En la fila de la key, tocá Revocar y confirmá. Desde ese momento, toda llamada con esa key responde 401.

Revocar no se puede deshacer: para volver a dar acceso, emití una key nueva. La key revocada sigue en la lista, con su último uso, como registro de que existió.

El equipo de Safety Panel también puede ver y revocar las keys de una cuenta desde el panel de administración, por ejemplo si una key se filtró.