API de Sincronizaci贸n de Jugadores

Versi贸n 1.0.0

馃攼 Autenticaci贸n

Todos los endpoints requieren autenticaci贸n mediante JWT Bearer Token

Formato: Authorization: Bearer <token>

Obtenci贸n: Solicitar token de acceso al administrador

Endpoints de Sincronizaci贸n

POST /jugadores/syncComet

Inicia la sincronizaci贸n de jugadores desde el sistema COMET

Par谩metros (JSON)

  • username: Usuario del sistema COMET
  • password: Contrase帽a del sistema COMET

Respuesta Exitosa (202)

{
    "message": "Sincronizaci贸n iniciada",
    "status": "success",
    "task_id": "uuid-generado"
}
POST /jugadores/syncLigaVeteranosCr

Inicia la sincronizaci贸n de jugadores desde Liga Veteranos

Par谩metros (JSON)

  • username: Usuario de Liga Veteranos
  • password: Contrase帽a de Liga Veteranos

Respuesta Exitosa (202)

{
    "message": "Sincronizaci贸n iniciada",
    "status": "success",
    "task_id": "uuid-generado"
}

Endpoints de Gesti贸n de Tareas

GET /jugadores/task/<task_id>

Consulta el estado de una tarea de sincronizaci贸n

Respuesta Exitosa (200)

{
    "task_id": "uuid-de-la-tarea",
    "type": "COMET|LIGA_VETERANOS",
    "status": "PENDING|PROCESSING|COMPLETED|ERROR",
    "created_at": "2024-01-01T12:00:00",
    "completed_at": "2024-01-01T12:05:00",
    "filename": "ruta/al/archivo.json",
    "error": "mensaje de error (si existe)"
}
GET /jugadores/download/<task_id>

Descarga el archivo JSON con los resultados de una sincronizaci贸n completada

Respuesta Exitosa (200)

Archivo JSON con los resultados de la sincronizaci贸n

Gu铆a de Uso

  1. Iniciar sincronizaci贸n usando syncComet o syncLigaVeteranosCr
  2. Guardar el task_id recibido en la respuesta
  3. Consultar el estado peri贸dicamente usando el endpoint task/<task_id>
  4. Una vez el estado sea COMPLETED, descargar los resultados usando download/<task_id>

Notas Importantes