Documentación API

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.

POST /api/cleanup/execute

Headers

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 Request

Parámetros inválidos.

{"error": "Se requiere al menos un status"}
403Forbidden

Sin permisos de administrador.

{"error": "Se requiere rol de administrador"}

GET /api/cleanup/states

Obtiene los estados disponibles para limpieza con conteo de extracciones.

GET /api/cleanup/states

Headers

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

401Unauthorized

Token inválido.

{"msg": "Token inválido"}

POST /api/cleanup/execute-automatic

Ejecuta limpieza automática según las reglas configuradas del cliente.

POST /api/cleanup/execute-automatic

Headers

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

403Forbidden

Sin permisos.

{"error": "Se requiere rol de administrador"}

GET /api/cleanup/status

Consulta el estado de una operación de limpieza asíncrona en curso.

GET /api/cleanup/status

Headers

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

401Unauthorized

Token inválido.

{"msg": "Token inválido"}

GET /api/cleanup/worker-status

Verifica el estado del worker de limpieza.

GET /api/cleanup/worker-status

Headers

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

401Unauthorized

Token inválido.

{"msg": "Token inválido"}

© 2025 Devol. Todos los derechos reservados.