Permisos
Qué son los scopes de una API Key, qué hacen hoy y qué decide de verdad a qué puedes acceder.
Los scopes todavía no restringen nada
AstrApp guarda los scopes con cada key, pero hoy ninguna ruta los revisa. Una key con solo projects:read puede crear proyectos o lanzar un entrenamiento igual que una con all. Elige scopes acotados para documentar el propósito de cada key, pero protégela como si tuviera acceso completo.
Scopes disponibles
Son los valores que acepta la API al crear una key y las casillas que ves en la app.
| Scope | En la app | Descripción |
|---|---|---|
all | Acceso completo | Valor por defecto. Al marcarlo, la app deshabilita los demás. |
projects:read | Proyectos (lectura) | Ver proyectos. |
projects:write | Proyectos (escritura) | Crear y modificar proyectos. |
training:read | Entrenamiento (lectura) | Ver trabajos de entrenamiento. |
training:write | Entrenamiento (escritura) | Iniciar entrenamientos. |
inference:read | Inferencia (lectura) | Ver modelos. |
inference:write | Inferencia (escritura) | Usar modelos para inferencia. |
documents:read | Documentos (lectura) | Ver documentos. |
documents:write | Documentos (escritura) | Subir y modificar documentos. |
Cualquier otro valor hace que la creación falle con 400. Si no mandas scopes, la key se crea con ["all"].
Qué decide tu acceso
Una petición con API Key se ejecuta como la persona dueña de la key.
Tu organización
La key actúa sobre tu organización activa. Ves y modificas los proyectos, datasets y modelos de esa organización, no los de otras.
Administrar el equipo (listar miembros, invitar, cambiar roles) exige ser owner o admin de la organización.
Tu plan
Cada ruta aplica los límites de tu plan: por ejemplo, el número de datasets o la descarga de adapters, que requiere Professional. Los límites completos están en Planes y precios.
Rutas que solo funcionan con sesión