Esta versão (v0.7) ainda não foi publicada no npm.
Pular para o conteúdo

Tenant e domínios ​

O gateway é multi-operador: cada request precisa dizer de qual operador é. O gateway descobre o operador pelo domínio do site do jogador, na ordem X-Original-Host → X-Forwarded-Host → Host. Um X-Tenant-ID enviado pelo cliente é ignorado.

Recomendado: proxy same-origin ​

Com baseUrl vazio (padrão), o SDK chama /api/v1/... na origem da página e envia X-Original-Host: location.host. Seu servidor encaminha /api ao gateway (veja Instalação). Não há CORS envolvido e o domínio do site identifica o operador.

Chamada direta ao gateway (cross-origin) ​

Com baseUrl: 'https://api.operador.com' no browser, o SDK não envia X-Original-Host, porque o CORS do gateway não permite esse header e o preflight falharia (isso vale mesmo se você informar tenantHost: no browser ele só é usado em chamadas same-origin). Nesse caso o operador é identificado pelo Host, então o domínio api.operador.com precisa estar cadastrado como domínio do operador no EngineX, e a origem do site precisa estar liberada no CORS.

Servidor ​

Fora do browser não existe location. Informe os dois:

ts
createEnginexClient({ baseUrl: 'https://gateway.operador.com', tenantHost: 'casino.operador.com' })

Sem eles, createEnginexClient não lança na criação: a resolução do tenant (e do fetch) é preguiçosa, calculada e memoizada só no primeiro request — o que importa para singletons do SDK importados num módulo top-level durante SSR (Next.js, Nuxt), antes mesmo de location existir. Se faltar baseUrl absoluto ou tenantHost na hora desse primeiro request, ele rejeita com EnginexError CONFIGURATION_ERROR, sem chamar fetch. Uma resolução que falhou não fica memoizada: o próximo request tenta de novo (por exemplo, se location passar a existir depois). Veja Next.js / SSR.

Checklist do operador ​

  1. Domínio do site cadastrado no operador (Admin EngineX).
  2. Proxy /api → gateway, ou domínio do gateway cadastrado + origem liberada no CORS.
  3. Em SSR, tenantHost igual ao domínio do site.