Qué es una API de casino

Una API es una forma definida de que un sistema le pida a otro información o una acción. Una API de casino aplica esa idea a la operación de un casino en línea: su plataforma pide juegos y los abre, y el lado del contenido le pregunta a su plataforma por saldos y apuestas. El contrato nombra las solicitudes, los campos, las respuestas y los errores, de modo que dos equipos pueden construir sobre él sin tener que hablar todos los días.

La API de WGC es una interfaz de servidor a servidor. Su servidor la llama con una clave en el encabezado X-API-Key, y cada respuesta llega en el mismo sobre: un indicador ok, un identificador de solicitud y datos o un error. Su código debe ramificarse solo por el código de error, porque el mensaje está escrito para las personas. Los navegadores no llaman a la API y las llamadas entre orígenes no se admiten, de modo que la clave se queda en su servidor.

Las cuatro tareas de una API de casino

1. El catálogo. Su plataforma pide los juegos asignados a su cuenta, 200 por página. Cada juego tiene un publicId estable que lo identifica en su catálogo y un universalId que es el mismo para el mismo juego en todo el catálogo. También tiene un nombre, un tipo, direcciones de imagen e indicadores de demo, giros gratis y otras capacidades. Tras la primera descarga completa usted envía la hora de su última sincronización y recibe solo los cambios, con un indicador para los juegos que debe retirar.

2. Abrir un juego. Cuando un jugador elige un juego en su lobby, su servidor le pide a la API que lo abra. La solicitud lleva el identificador del jugador, la moneda, el modo (real o demo) y el número de un juego. La respuesta es un enlace de lanzamiento que abre el navegador del jugador, dentro de un marco si usted lo prefiere. El enlace sin abrir funciona cinco minutos, y un enlace abierto funciona mientras el jugador esté activo.

3. La billetera. Durante el juego, el juego necesita un saldo y debe registrar apuestas y ganancias. En un modelo de billetera seamless, el dinero del jugador se queda en su plataforma, así que es la API la que lo llama a usted: WGC envía solicitudes firmadas a su Callback URL con tres comandos, uno para leer el saldo, otro para registrar una apuesta junto con su ganancia y otro para cancelar una apuesta. Este es el tema de la página de billetera seamless.

4. Las consultas de estado. Después, su plataforma puede preguntar qué pasó con una operación, una ronda o una sesión, usando sus propios números. Una operación tiene un estado como aceptada, rechazada, fallida o desconocida, y una ronda informa la apuesta, la ganancia y la diferencia.

Dos direcciones de llamadas

Ayuda imaginar las llamadas yendo en ambos sentidos. En la primera dirección, su servidor llama a WGC: lee el catálogo, abre juegos y consulta estados. En la segunda dirección, WGC llama a su plataforma: lee saldos y registra apuestas, ganancias y cancelaciones. Ambas direcciones forman parte del mismo contrato, y una integración solo está terminada cuando funcionan las dos.

La segunda dirección lleva las reglas más estrictas, porque mueve dinero. Cada llamada se firma con HMAC-SHA256 y el secreto de su cuenta, y su manejador debe verificar la firma sobre el cuerpo en bruto antes de analizarlo. WGC espera su respuesta tres segundos. Una apuesta se registra una sola vez por identificador de transacción, de modo que una llamada repetida no debita dos veces al jugador ni cambia el saldo devuelto.

Cómo viaja una ronda

Este es el camino de un solo juego, paso a paso.

  1. Su plataforma sincronizó el catálogo y muestra los juegos en su lobby.
  2. El jugador elige un juego y su servidor pide abrirlo.
  3. WGC devuelve un enlace de lanzamiento y el navegador del jugador lo abre.
  4. El juego pide el saldo. WGC llama a su Callback URL, usted responde y el juego comienza.
  5. Por cada apuesta, WGC lo llama de nuevo con la apuesta y, normalmente en la misma llamada, su ganancia.
  6. Si su respuesta no llega a tiempo, la apuesta se rechaza al estudio, la operación queda como desconocida y WGC más tarde le pide cancelarla con un rollback.
  7. Después de la ronda, su plataforma puede consultar la operación, la ronda o la sesión por sus propios números.

Qué hace fácil de verificar una API de casino

Un equipo técnico debería poder juzgar una API antes de comprometerse con ella. Con WGC, la descripción de la API es pública: un archivo OpenAPI y una página de documentación, ambos abiertos sin clave. Si difieren, el archivo manda. La API no se rompe sin aviso: pueden aparecer campos nuevos, así que usted ignora los que no conoce, y un campo se elimina solo tras un aviso de obsolescencia y no antes de 90 días.

Los límites también están escritos. De forma predeterminada, una clave puede abrir 600 juegos por minuto, y las solicitudes de catálogo y de estado permiten 120 por minuto. Su gerente puede subir los límites de una cuenta a pedido.

Probar no requiere dinero real. Una clave de prueba abre un juego de prueba, WGC Test Slot, que hace llamadas reales a su Callback URL. En el back office, una verificación de integración muestra un registro en vivo de cada llamada, y una prueba de integración ejecuta 14 verificaciones de su billetera. Los ejemplos de manejadores, un script de verificación y una lista de puesta en producción son públicos. Puede leer más en la página de integración y en demo y modo de prueba.

Lo que una API de casino no es

Una API de casino no es un casino para jugadores. WGC no opera un casino, no mantiene saldos de jugadores y no registra jugadores: su plataforma conserva a sus propios jugadores y su dinero. El acceso al área de clientes lo entrega personalmente un gerente, y no hay registro por cuenta propia. Una API de casino tampoco es una promesa sobre el resultado de un juego: un RTP elegido es un ajuste que se entrega al estudio, y no todos los juegos lo aceptan.

Para la lista completa de solicitudes y cómo encajan, vea la descripción general de la API de casino.