Primeros Pasos

Bienvenido a la API de Reportes para Clientes. Esta guía le ayudará a realizar su primera llamada a la API en minutos.

Obtenga su Client Secret

Su client secret es un UUID que identifica de manera única su cuenta de operador. Para obtener uno:

1. Contacte a su administrador de cuenta o al equipo de soporte de la plataforma.
2. Recibirá un UUID en el formato: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
3. Almacénelo de forma segura — trátelo como una contraseña.

WARNING

Su client secret otorga acceso completo a sus datos de reportes. Nunca lo exponga en código del lado del cliente, repositorios públicos o URLs.

URL Base

Todas las solicitudes a la API se realizan a:

https://api.syssoft1.com

Autenticación

Cada solicitud debe incluir su client secret en el header X-Client-Secret:

X-Client-Secret: your-uuid-secret-here

Consulte la página de Autenticación para información detallada.

Headers Comunes

Incluya estos headers en cada solicitud:

Header	Valor	Requerido
X-Client-Secret	Su UUID secret	Sí
Accept	application/json	Sí

Límite de Solicitudes

La API aplica un límite de 60 solicitudes por minuto por client secret. Si excede este límite, recibirá una respuesta 429 Too Many Requests. Consulte Manejo de Errores para más detalles.

Inicio Rápido — Su Primera Solicitud

Obtenga sus últimas transacciones con un simple comando curl:

curl -X GET 'https://api.syssoft1.com/api/client/reports/transactions?page=1&filter[per_page]=10' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: your-uuid-secret-here'

Una respuesta exitosa se ve así:

{
  "data": [
    {
      "id": 12345,
      "type": "DEBIT",
      "amount": 10.00,
      "currency": "USD",
      "player": "player123",
      "provider": "Pragmatic Play",
      "game": "Sweet Bonanza",
      "created_at": "2026-04-13 10:30:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total": 150,
    "per_page": 10,
    "total_pages": 15
  },
  "totals": { ... }
}

Endpoints Disponibles

Endpoint	Descripción
GET /api/client/reports/transactions	Historial de transacciones con filtros y totales agregados
GET /api/client/reports/daily-games	Rankings de rendimiento de juegos con sistema de niveles
GET /api/client/reports/players	Analíticas de jugadores con datos de actividad y rentabilidad

Próximos Pasos

• Lea la guía de Autenticación para mejores prácticas de seguridad.
• Explore la Referencia API para documentación detallada de endpoints.
• Revise el Manejo de Errores para entender cómo se devuelven los errores.
• Consulte el Glosario para la terminología utilizada en la API.