Tenant y dominios
El gateway es multioperador: cada request debe decir de qué operador es. El gateway descubre el operador por el dominio del sitio del jugador, en el orden X-Original-Host → X-Forwarded-Host → Host. Un X-Tenant-ID enviado por el cliente se ignora.
Recomendado: proxy same-origin
Con baseUrl vacía (por defecto), el SDK llama a /api/v1/... en el origen de la página y envía X-Original-Host: location.host. Tu servidor reenvía /api al gateway (consulta Instalación). No hay CORS de por medio y el dominio del sitio identifica al operador.
Llamada directa al gateway (cross-origin)
Con baseUrl: 'https://api.operador.com' en el browser, el SDK no envía X-Original-Host, porque el CORS del gateway no permite ese header y el preflight fallaría (esto ocurre incluso si indicas tenantHost: en el browser solo se usa en llamadas same-origin). En ese caso el operador se identifica por el Host, así que el dominio api.operador.com debe estar registrado como dominio del operador en EngineX, y el origen del sitio debe estar permitido en el CORS.
Servidor
Fuera del browser no existe location. Indica ambos:
createEnginexClient({ baseUrl: 'https://gateway.operador.com', tenantHost: 'casino.operador.com' })Sin ellos, createEnginexClient no lanza al crearse: la resolución del tenant (y del fetch) es perezosa, se calcula y se memoiza solo en el primer request — lo que importa para singletons del SDK importados en un módulo de nivel superior durante el SSR (Next.js, Nuxt), antes incluso de que location exista. Si falta una baseUrl absoluta o tenantHost en el momento de ese primer request, rechaza con EnginexError CONFIGURATION_ERROR, sin llamar a fetch. Una resolución que falló no queda memoizada: el próximo request lo intenta de nuevo (por ejemplo, si location pasa a existir después). Consulta Next.js / SSR.
Checklist del operador
- Dominio del sitio registrado en el operador (Admin de EngineX).
- Proxy
/api→ gateway, o dominio del gateway registrado + origen permitido en el CORS. - En SSR,
tenantHostigual al dominio del sitio.