Permisos y alcance
La autenticación determina tanto las operaciones disponibles como los recursos que se pueden consultar. El token de usuario permite trabajar con todos los recursos del usuario, incluidos los creados mediante cualquiera de sus API Keys. Una API Key solo permite trabajar con los recursos creados usando esa misma clave.
| Operación | Token de usuario | API Key | Alcance |
|---|---|---|---|
/users/me y /users/me/subscriptions | Sí | No | Información y suscripción del usuario |
| Crear, listar, consultar, actualizar, revocar, activar y eliminar API Keys | Sí | No | Claves del usuario |
POST /files | Sí | Sí | La API Key queda asociada al fichero creado |
| Listar, consultar, descargar y eliminar ficheros | Todos los ficheros del usuario | Solo ficheros creados con la clave | El alcance depende de las credenciales |
| Crear ejecuciones | Sobre ficheros del usuario | Solo sobre ficheros creados con la clave | La ejecución queda asociada a las credenciales |
| Listar y consultar ejecuciones y resultados | Todos los recursos del usuario | Solo recursos creados con la clave | Incluye los archivos de resultados |
| Gestionar comentarios de ficheros | Sí, sobre recursos accesibles | No | Los comentarios se gestionan con credenciales de usuario |
Una API Key no puede utilizarse para gestionar otras API Keys ni para acceder a los recursos creados con otra API Key. Si se intenta realizar una operación fuera de este alcance, la API puede devolver 401 Unauthorized, 403 Forbidden o 404 Not Found, según la operación y el recurso.
Los límites de almacenamiento, ejecuciones, concurrencia y número de API Keys dependen del tier del usuario. Consulta Tiers y límites para conocer los valores publicados.