Skip to content

Reporte de Jugadores ​

GET /api/client/reports/players

Obtenga una lista paginada de jugadores con analíticas integrales incluyendo actividad, resumen financiero, RTP y rentabilidad. La respuesta incluye detalles por jugador y totales agregados de todos los registros coincidentes.

Parámetros de Consulta ​

ParámetroTipoRequeridoDescripción
pageintegerNoNúmero de página (por defecto: 1)
filter[per_page]integerNoElementos por página (por defecto: 50)
filter[fromDate]stringNoFecha de inicio en formato YYYY-MM-DD
filter[toDate]stringNoFecha de fin en formato YYYY-MM-DD
filter[provider_id][]integerNoFiltrar por ID(s) de proveedor
filter[currency_id][]stringNoFiltrar por código(s) ISO de moneda (ej., USD, CRC)
filter[has_transactions]booleanNoSolo incluir jugadores con transacciones (true / false)
filter[search]stringNoBuscar por nombre de usuario del jugador

Combinación de Filtros

Puede combinar múltiples filtros para acotar los resultados. Por ejemplo, para encontrar jugadores activos en USD de un proveedor específico:

?filter[has_transactions]=true&filter[currency_id][]=USD&filter[provider_id][]=5

Solicitud ​

Headers ​

HeaderValorRequerido
Acceptapplication/jsonSí
X-Client-SecretSu UUID secretSí

Ejemplo de Solicitud ​

bash
curl -X GET 'https://api.syssoft1.com/api/client/reports/players?page=1&filter[per_page]=50&filter[has_transactions]=true' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Ejemplo con Búsqueda ​

bash
curl -X GET 'https://api.syssoft1.com/api/client/reports/players?filter[search]=player123' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Ejemplo con Rango de Fechas y Moneda ​

bash
curl -X GET 'https://api.syssoft1.com/api/client/reports/players?page=1&filter[fromDate]=2026-03-01&filter[toDate]=2026-04-13&filter[currency_id][]=USD&filter[currency_id][]=CRC' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Respuesta ​

Respuesta Exitosa — 200 OK ​

json
{
  "data": [
    {
      "id": 789,
      "username": "player123",
      "client": "inte",
      "country": "CR",
      "currency": "USD",
      "status": true,
      "total_transactions": 450,
      "games_played": 12,
      "total_bets": {
        "raw": 5000.00,
        "formatted": "$5,000.00",
        "large_number": "5K"
      },
      "total_wins": {
        "raw": 4200.00,
        "formatted": "$4,200.00",
        "large_number": "4.2K"
      },
      "total_rollbacks": {
        "raw": 100.00,
        "formatted": "$100.00",
        "large_number": "100"
      },
      "total_free_spins": {
        "raw": 50.00,
        "formatted": "$50.00",
        "large_number": "50"
      },
      "profit": {
        "raw": 650.00,
        "formatted": "$650.00",
        "large_number": "650"
      },
      "rtp": "86.00%",
      "last_activity": "2026-04-13 09:15:00",
      "created_at": "2026-01-15 08:00:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total": 45,
    "per_page": 50,
    "total_pages": 1
  },
  "totals": {
    "total_players": 45,
    "total_transactions": 12500,
    "total_bets": {
      "raw": 250000.00,
      "formatted": "$250,000.00",
      "large_number": "250K"
    },
    "total_wins": {
      "raw": 225000.00,
      "formatted": "$225,000.00",
      "large_number": "225K"
    },
    "profit": {
      "raw": 25000.00,
      "formatted": "$25,000.00",
      "large_number": "25K"
    },
    "return_to_player": "90.00%"
  }
}

Campos de la Respuesta ​

data[] — Registros de Jugadores ​

CampoTipoDescripción
idintegerIdentificador único del jugador
usernamestringNombre de usuario del jugador
clientstringIdentificador del cliente/operador
countrystringCódigo de país ISO (ej., CR, US)
currencystringCódigo ISO de moneda del jugador
statusbooleanSi la cuenta del jugador está activa
total_transactionsintegerNúmero total de transacciones
games_playedintegerNúmero de juegos distintos jugados
total_betsobjectMonto total apostado con raw, formatted, large_number
total_winsobjectMonto total ganado con raw, formatted, large_number
total_rollbacksobjectMonto total de rollbacks con raw, formatted, large_number
total_free_spinsobjectMonto total de giros gratis con raw, formatted, large_number
profitobjectGanancia neta de este jugador con raw, formatted, large_number
rtpstringPorcentaje de Retorno al Jugador
last_activitystringMarca de tiempo de la última actividad (YYYY-MM-DD HH:mm:ss)
created_atstringMarca de tiempo de creación de la cuenta (YYYY-MM-DD HH:mm:ss)

pagination — Información de Paginación ​

CampoTipoDescripción
current_pageintegerNúmero de página actual
totalintegerNúmero total de registros
per_pageintegerRegistros por página
total_pagesintegerNúmero total de páginas

totals — Totales Agregados ​

El objeto totals proporciona valores agregados de todos los registros que coinciden con los filtros actuales (no solo la página actual).

CampoTipoDescripción
total_playersintegerNúmero total de jugadores que coinciden con los filtros
total_transactionsintegerSuma de todas las transacciones de jugadores
total_betsobjectApuestas agregadas con raw, formatted, large_number
total_winsobjectGanancias agregadas con raw, formatted, large_number
profitobjectGanancia agregada con raw, formatted, large_number
return_to_playerstringPorcentaje de RTP general de todos los jugadores

Entendiendo las Métricas de Jugadores ​

RTP (Retorno al Jugador) ​

El campo rtp representa el porcentaje del total de apuestas que fue devuelto al jugador como ganancias y rollbacks.

Fórmula: (total_wins + total_rollbacks) / total_bets * 100

Un RTP más bajo indica mayor rentabilidad para el operador.

Ganancia ​

El campo profit representa el ingreso neto generado por el jugador.

Fórmula: total_bets - total_wins - total_rollbacks

Estado ​

El campo status indica si la cuenta del jugador está actualmente activa (true) o inactiva (false). Los jugadores inactivos pueden seguir apareciendo en reportes históricos.

Pruébelo ​

⚡API PlaygroundGET

Parámetros

pageinteger
Page number
filter[per_page]integer
Items per page
filter[fromDate]string
Start date (YYYY-MM-DD)
filter[toDate]string
End date (YYYY-MM-DD)
filter[provider_id][]array
Provider IDs
filter[currency_id][]string
Currency ISO codes
filter[has_transactions]boolean
Only players with transactions
filter[search]string
Search by username

URL de Petición

https://api.syssoft1.com/api/client/reports/players

Respuestas de Error ​

CódigoDescripción
401Client secret inválido o inactivo. Consulte Autenticación.
422Parámetros de consulta inválidos. Verifique los tipos y formatos de los parámetros.
429Límite de solicitudes excedido. Espere y reintente. Consulte Manejo de Errores.

Documentación de la API para Clientes