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

GET /jugadores/data/<task_id>

Obtiene los datos de una tarea completada directamente en formato JSON

Respuesta Exitosa (200)

[
    {
        "foto": "base64...",
        "nombre": "Juan Perez",
        "dni": "12345678",
        ...
    }
]

Ejemplos de Uso (cURL)

1. Login (Obtener Token)

curl -X POST http://localhost:5000/auth/login   -H "Content-Type: application/json"   -d '{
    "username": "tu_usuario",
    "password": "tu_password"
  }'

2. Iniciar Sincronizaci贸n

curl -X POST http://localhost:5000/jugadores/syncComet   -H "Authorization: Bearer TU_TOKEN"   -H "Content-Type: application/json"   -d '{
    "username": "usuario_comet",
    "password": "password_comet"
  }'

3. Consultar Estado

curl -X GET http://localhost:5000/jugadores/task/TASK_ID   -H "Authorization: Bearer TU_TOKEN"

4. Obtener Datos JSON

curl -X GET http://localhost:5000/jugadores/data/TASK_ID   -H "Authorization: Bearer TU_TOKEN"

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