Autenticación
Toda operación de /v1 salvo el catálogo público exige autenticación. El método documentado para integraciones es la API key, enviada en la cabecera Authorization con el esquema Bearer:
Authorization: Bearer veriko_a1b2c3d4e5f6...La clave identifica a la cuenta y determina tanto los permisos aplicables como la cuota consumida. No lleva caducidad: vale hasta que se regenera o hasta que se cierran todas las sesiones de la cuenta (cambio o recuperación de contraseña, «cerrar todas las sesiones» o cierre forzado); a partir de ahí responde 401 con session_invalidated y hay que regenerarla.
Obtención y rotación
La clave se consulta y se sustituye desde el panel (GET /v1/users/me/api-key y POST /v1/users/me/api-key/regenerate sólo aceptan la sesión de la consola, no la API key). La regeneración invalida la anterior de forma inmediata: cualquier integración que siga usándola empieza a recibir 401 en la petición siguiente.
Las lecturas exponen únicamente el prefijo y los últimos caracteres de la clave. El valor completo se muestra al generarla, y la consola puede volver a mostrarlo después exigiendo la contraseña de la cuenta.
Respuestas de autenticación fallida
| código | situación |
|---|---|
unauthorized | Falta la cabecera Authorization |
invalid_api_key | La clave no corresponde a ninguna cuenta |
session_invalidated | La clave se emitió antes de un cierre de todas las sesiones |
account_suspended | La cuenta está suspendida o dada de baja |
Todas responden 401 con la forma habitual del documento de error.
Una clave válida sobre una operación para la que la cuenta no tiene permiso responde 403 con permission_denied, no 401: la diferencia entre ambos es identidad frente a autorización.
Operaciones exclusivas de la consola
La consola web se autentica por su cuenta, con un método propio que no es la API key. Panel y API pública además no exponen el mismo conjunto de operaciones. Las operaciones de administración solo aceptan el método de la consola, de modo que una API key válida recibe 403 con auth_method_denied al invocarlas.
Cada operación declara los métodos que admite en su página de referencia. Las de /v1 orientadas a integración aceptan ambos.