Una clave de API parece una cadena aleatoria, pero la de Qomni cuenta una
historia: sk_agents_live_co1_8fK2…Qa91Zx. Cada parte está ahí por una razón
concreta, y las razones son el tema de esta nota.
El producto, en la clave
Cada producto de Qomni tiene su API, su consumo y su factura. Una clave vale
para un solo producto. Con una clave de Agents puedes llamar a
api.qomni.ai/agents/v1 y a nada más; en otra API falla con
401 api_key_wrong_product.
Es una decisión de superficie de ataque. Un sistema que crea llamadas recibe una clave de Agents y, si esa clave se filtra, el atacante no entra a la app web ni a la cuenta. Y revocar una clave no toca a las demás.
El modo, en la clave
live o test no es un ajuste de la cuenta: lo decide la clave. Una clave
de prueba trabaja sobre datos separados, no marca ningún número y no factura.
El código es el mismo; cambia una variable de entorno. Así, lo que pruebas
es exactamente lo que va a correr en producción.
La celda, para no consultar nada
co1 dice dónde viven los datos del workspace. El edge lee ese prefijo y
envía la petición a la celda correcta sin buscar en ninguna base de datos.
Es la razón por la que la URL de la API nunca lleva región.
El checksum, para fallar temprano
Los últimos seis caracteres son un CRC32 del resto, en base62. Una clave mal
copiada se rechaza en el edge, con 401 api_key_malformed, antes de llegar a
ningún servidor. Soporte reconoce ese error sin mirar nada más.
Lo que no está en la clave
Qomni guarda sólo el hash SHA-256 de cada clave. Por eso la clave completa se muestra una sola vez, al crearla, y después sólo se ven su prefijo y sus últimos cuatro caracteres. Una clave perdida no se recupera: se crea otra y se revoca la anterior.
Y los límites
Cada clave tiene su propio presupuesto: 120 peticiones por minuto. Las
peticiones rechazadas con 401 se cuentan aparte, por dirección IP, para que
un cliente mal configurado no agote el presupuesto de las claves válidas de
la misma red.
La anatomía completa está en API keys y autenticación.
Recibe un aviso con cada artículo nuevo
Una nota de ingeniería cada vez que publicamos; nada más.