Emitir una key

1. En el panel administrativo, 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».
4. En Permisos, elegí para cada recurso Sin acceso, Lectura o Lectura y escritura. Todos empiezan en Sin acceso: dale solo lo que ese sistema necesita. Tiene que tener al menos un recurso con acceso.
5. Tocá Crear key.
6. Arriba de la lista aparece la key nueva. Tocá 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.

Los permisos no se cambian después de emitir la key. Si un sistema necesita otros, emití una key nueva con esos permisos y revocá la anterior. Ver qué deja hacer cada nivel en Permisos.

La misma página muestra la dirección base de la API de la cuenta: es la que tiene que usar el sistema externo. Para comprobar que la key funciona, pedí un recurso al que le diste acceso, por ejemplo la cuenta:

curl https://tuempresa.safetypanel.com.ar/api/v1/account \
  -H "Authorization: Bearer spk_…"

Si la respuesta es 401, la key está mal copiada o es de otra cuenta. Si es 403 con el código module_disabled, la cuenta no tiene la API habilitada. Si es 403 con el código insufficient_scope, la key funciona pero no tiene permiso sobre ese recurso: el mensaje dice cuál le falta.

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.
Permisos	Qué recursos lee y cuáles lee y modifica.
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.

El último uso sirve para encontrar las keys que ya nadie usa y revocarlas.

Keys anteriores a los permisos

Las keys emitidas antes de que existieran los permisos aparecen en la lista como Anterior a los permisos. Siguen funcionando igual que siempre y conservan exactamente su acceso anterior: leen la cuenta, los sitios, los grupos de sitios y los profesionales, y solo modifican sus campos externos. Nunca ganan acceso nuevo, ni a recursos que se agreguen a la API ni a escrituras nuevas sobre esos cuatro.

Para elegirle permisos a un sistema que usa una de estas keys, emití una key nueva, cambiala en ese sistema y revocá la anterior.