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…