API: visão geral

A API Meus Clubes é versionada por caminho. Para produção, use:

https://api.meusclubes.com/api/v1

Em desenvolvimento local:

http://127.0.0.1:8787/api/v1

Todas as rotas documentadas abaixo são relativas a essa base. A API publica duas referências geradas diretamente pelo Worker:

• Swagger UI para explorar as rotas.
• OpenAPI JSON para geração de clientes e validação automatizada.

Fluxo recomendado

1. Resolva o clube pelo host quando o acesso começar em um domínio white-label.
2. Faça login informando o clube escolhido.
3. Envie o access token no header Authorization e o clube no header X-Club-Id.
4. Para rotas de clube, confirme que o clubId da URL é o mesmo valor do header.
5. Renove a sessão usando o refresh token antes de o access token expirar.

As respostas de sucesso usam o envelope success: true e data. Listagens paginadas também retornam pagination.