Eel

Claves de API

Credenciales que actúan como el espacio de trabajo, con los permisos que les des.

¿Quién puede usar esto? Solo el propietario del espacio y sus administradores crean, ven y revocan claves de API.

Crea una clave de API para que un script, una integración o una automatización trabaje con Eel sin que haya una persona detrás.

Una clave actúa como el espacio de trabajo entero, con los permisos que marcaste. No hereda los tuyos ni los de nadie.

La tabla

Columna Qué muestra
Nombre Para qué la creaste.
Clave Solo su mitad pública, eel_sk_….
Permisos Cuántos tiene. Cuáles elegiste al crearla.
Último uso Cuándo respondió una petición por última vez, o "Nunca".
Estado Activa, vencida o revocada.

La tabla de claves: el nombre, el prefijo de la clave, cuántos permisos tiene, el último uso y el estado, activa o revocada.

Crear una

Abre Nueva clave y dale un nombre, al menos un permiso y, si quieres, una fecha de vencimiento.

Elige los permisos, agrupados por aplicación. Algunos ejemplos:

  • wrap:contacts:read leer contactos y empresas
  • wrap:deals:write actualizar negocios
  • swarm:tasks:write crear y actualizar tareas
  • nest:workspace:read leer espacio y miembros
  • flow:sales:write registrar ventas

Marca solo lo que la clave necesita: hay 32 permisos repartidos entre las cuatro aplicaciones, y todo lo que no marques queda denegado. No hay permisos implícitos, ni uno que arrastre a otro.

Las casillas de permisos del diálogo de creación, agrupadas por aplicación y con ninguna marcada.

Copia la clave al crearla

Copia la clave completa en el momento en que la creas, con el botón de copiar. Después no vuelve a aparecer, y nosotros tampoco podemos mostrártela otra vez. Si la perdiste, revoca esa y crea otra.

El ritmo permitido

Cada permiso pertenece a una clase, y la clase fija cuántas peticiones por minuto pasan:

Clase Por minuto
Lectura 120
Escritura 30
Administración 30

Cada endpoint exige un permiso concreto, y el conteo va por clave y por permiso: leer mucho no te gasta el presupuesto de escritura. Si te pasas, recibes un error de límite con un Retry-After, no un fallo silencioso: espera los segundos que indique y vuelve a intentar.

Revocar

Revoca la clave desde su fila y confirma. Cualquier sistema que estuviera usando esa clave deja de funcionar en un minuto, y no se puede deshacer. Nest deja la clave revocada en la lista, para que el historial no tenga huecos.

Si sospechas que una clave se filtró, revócala. No hay motivo para dudarlo: crear otra cuesta un minuto.