Referencia de la API
Origen del contrato
arlesfarias/l3backups.com
- Versión de la aplicación
- 2.1.0
- Versión de la API
- 1.0.0
- Revisión
93de3d9c6f455ffc4678fc41a400b805bdd81594- SHA-256
9e76e40b0416f10ee94361525456a9b0e2852871b03daa2a43ba59759d39ff73
Descargar contrato OpenAPI · API 1.0.0
Textos traducidos del contrato oficial. Se conservan identificadores y ejemplos JSON; la descarga contiene el original.
Descripción general, autenticación y límites
API pública v1 (publicada). Use el host HTTPS de su tenant. Solo Authorization: Bearer autentica las solicitudes; se ignoran las cookies del navegador. Las credenciales son opacas, no son JWT. La expiración, revocación, permisos de acción independientes y acceso actual a los recursos se verifican en la persistencia en cada solicitud. Los grupos seleccionados autorizan a sus miembros actuales, junto con los dispositivos seleccionados individualmente. Ningún permiso de acción implica otro. Los recursos fuera del tenant o del alcance del token devuelven 404. Todas las llamadas procesadas en un tenant identificado se auditan antes de liberar datos o mutaciones; los fallos de persistencia bloquean la operación con 503. No se exponen credenciales, comandos ni URL de almacenamiento. Límites compartidos predeterminados por ventana fija de un minuto: 30 intentos por origen/tenant antes de la autenticación (incluidas solicitudes válidas), 120 solicitudes por token y 600 por tenant. La configuración del backend puede cambiar estos límites. 429 incluye Retry-After en segundos. La revocación bloquea nuevas llamadas; los trabajos aceptados continúan. La rotación invalida inmediatamente las credenciales anteriores. Las restricciones del ciclo de vida del tenant, facturación y confianza SSH siguen prevaleciendo. Se permiten cambios aditivos en v1; los cambios incompatibles requieren deprecación documentada y una nueva versión de la API. La versión de OpenAPI no modifica /api/v1.
Operaciones
Cargando referencia…