Cleanup
Gestión de limpieza de extracciones. Permite eliminar extracciones antiguas o con estados específicos.
POST /api/cleanup/execute
Ejecuta una limpieza de extracciones según los criterios especificados.
/api/cleanup/executeHeaders
Content-Type: application/json
Authorization: Bearer JWT_TOKEN Body (JSON)
{"status": ["error", "descartado"], "older_than_days": 90} status: (obligatorio) Lista de estados a limpiar.older_than_days: (opcional) Solo extracciones más antiguas que N días.
Ejemplos
curl -X POST https://api-docmind.devol.es/api/cleanup/execute \
-H "Content-Type: application/json" -H "Authorization: Bearer JWT_TOKEN" \
-d '{"status": ["error"], "older_than_days": 90}' Respuesta
{"message": "Limpieza ejecutada", "deleted_count": 25}Número de extracciones eliminadas.
Errores
400Bad RequestParámetros inválidos.
{"error": "Se requiere al menos un status"}403ForbiddenSin permisos de administrador.
{"error": "Se requiere rol de administrador"}GET /api/cleanup/states
Obtiene los estados disponibles para limpieza con conteo de extracciones.
/api/cleanup/statesHeaders
Authorization: Bearer JWT_TOKEN Ejemplos
curl -X GET https://api-docmind.devol.es/api/cleanup/states \
-H "Authorization: Bearer JWT_TOKEN" Respuesta
{"states": [{"status": "error", "count": 25}, {"status": "descartado", "count": 10}, {"status": "archivado", "count": 50}]}Estados con la cantidad de extracciones en cada uno.
Errores
401UnauthorizedToken inválido.
{"msg": "Token inválido"}POST /api/cleanup/execute-automatic
Ejecuta limpieza automática según las reglas configuradas del cliente.
/api/cleanup/execute-automaticHeaders
Authorization: Bearer JWT_TOKEN Ejemplos
curl -X POST https://api-docmind.devol.es/api/cleanup/execute-automatic \
-H "Authorization: Bearer JWT_TOKEN" Respuesta
{"message": "Limpieza automática ejecutada", "deleted_count": 15, "rules_applied": 3}Resultados de la limpieza automática.
Errores
403ForbiddenSin permisos.
{"error": "Se requiere rol de administrador"}GET /api/cleanup/status
Consulta el estado de una operación de limpieza asíncrona en curso.
/api/cleanup/statusHeaders
Authorization: Bearer JWT_TOKEN Ejemplos
curl -X GET https://api-docmind.devol.es/api/cleanup/status \
-H "Authorization: Bearer JWT_TOKEN" Respuesta
{"status": "completado", "progress": 100, "deleted_count": 25, "started_at": "...", "completed_at": "..."}Estado actual de la operación: pendiente, en_proceso, completado.
Errores
401UnauthorizedToken inválido.
{"msg": "Token inválido"}GET /api/cleanup/worker-status
Verifica el estado del worker de limpieza.
/api/cleanup/worker-statusHeaders
Authorization: Bearer JWT_TOKEN Ejemplos
curl -X GET https://api-docmind.devol.es/api/cleanup/worker-status \
-H "Authorization: Bearer JWT_TOKEN" Respuesta
{"worker_active": true, "last_execution": "2025-07-24T03:00:00Z", "next_scheduled": "2025-07-25T03:00:00Z"}Estado del worker automático de limpieza.
Errores
401UnauthorizedToken inválido.
{"msg": "Token inválido"}