Pular para conteúdo

Contexto do clube

Meus Clubes é multi-tenant: cada operação pertence a um clube. O contexto é transportado por club_id e validado em todas as rotas de clube.

Resolver um domínio

GET /tenant/resolve?host=<host> é público e resolve o clube ativo pelo hostname. Ele aceita o host white-label padrão, como <slug>.meusclubes.com, ou um domínio personalizado previamente cadastrado.

curl 'https://api.meusclubes.com/api/v1/tenant/resolve?host=clube-exemplo.meusclubes.com'

O hostname não substitui a autenticação. Depois de identificar o clube, o cliente ainda precisa fazer login e enviar X-Club-Id nas rotas protegidas.

Regras de consistência

  • Em /clubs/{clubId}/..., o clubId da URL deve ser igual ao X-Club-Id.
  • Não confie em um clubId informado pelo usuário sem validar o vínculo retornado pelo login.
  • Um domínio desconhecido, inativo ou não cadastrado não deve ser tratado como pertencente a um clube.
  • O console fixo console.meusclubes.com é o ponto de entrada da aplicação; o clube ativo é resolvido no fluxo do console, não por um caminho público arbitrário.