Lista events

GET/api/events

Auth: Public
Clé d’API:: events:read
X-CommunityId: X-CommunityId Envoyez le X-CommunityId de la communauté où l’opération a lieu.

Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.

Autenticação opcional. Sempre só os eventos da comunidade do `X-CommunityId` (sem login e SuperAdmin inclusive). Sem login: `public`; membro: também `members`, e `plan` com assinatura ativa; owner, admin, moderador e finance: também `plan`. `private` não sai na listagem (SuperAdmin vê tudo). Evento aguardando moderação ou recusado só sai para a equipe e o SuperAdmin. A mesma regra do feed e do detalhe. Evento vendido por produto pago que a pessoa não pode entrar sai com `requiresPurchase: true` e `streamingUrl`, `recordingMediaId` e endereço em `null`, como no detalhe; `requiresPurchase` vem sempre. Cada evento traz `issuesCertificate` (o evento emite certificado agora) e, **só para owner, admin e SuperAdmin**, o bloco `certificate` (`EventCertificateConfig`). As colunas internas do certificado não saem.

Paramètres

Nom	Emplacement	Type	Description
`spaceId`facultatif	query	`string (uuid)`
`filter`facultatif	query	`next \| my \| past \| all`	`my`: os eventos em que a pessoa vai (RSVP `going`/`maybe`) ou tem ingresso ativo; sem `spaceId`, de todos os espaços que ela pode abrir (os outros filtros, sem `spaceId`, listam só os eventos fora de espaço). Os ingressos em si: `GET /api/my/tickets`.
`search`facultatif	query	`string`
`status`facultatif	query	`PUBLISHED \| DRAFT \| all`	Rascunhos do editor de eventos. Padrão: só publicados. `DRAFT` (os "Rascunhos", sem filtro de data) e `all` só trazem rascunho para a equipe (owner, admin, moderador, financeiro) e o SuperAdmin; para os demais o rascunho nunca sai. Cada evento traz `status`, `publishedAt` e `updatedAt`.
`from`facultatif	query	`string (date-time)`	Calendário: início do período (ISO 8601). Vai junto com `to`. Com período, a lista traz os eventos que cruzam `[from, to]` (começam até `to` e terminam a partir de `from`; sem fim, começam dentro do período), em ordem de `startTime` crescente, sem paginação e no máximo 300 (os mais cedo): acima disso, `truncated: true` ao lado de `data`. `filter=next\|past` é ignorado; `filter=my`, `status`, `search` e `spaceId` se combinam. Evento sem data nunca entra. Data inválida, só uma das duas, `to` antes de `from` ou mais de 62 dias entre elas: 400 com `errors[0].param` em `from` ou `to`. Sem `from`/`to`, nada muda na lista.
`to`facultatif	query	`string (date-time)`	Fim do período (ISO 8601, inclusivo), no máximo 62 dias depois de `from`.
`undated`facultatif	query	`true \| false`	`true` lista só os eventos sem data (`startTime` nulo), com as mesmas regras de período (teto de 300, `truncated`, `undatedCount`); `from`/`to` e `filter=next\|past` são ignorados. Com período ou `undated=true`, a resposta traz também `undatedCount`, quantos eventos sem data a mesma busca tem (o "Sem data (N)" abaixo do calendário).

En-têtes

Nom	Type	Description
`X-CommunityId`facultatif	`string (uuid)`	ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Réponses

Statut	Description
`200`	Lista de eventos. Com `from`/`to` ou `undated=true`, também `truncated` (boolean) e `undatedCount` (inteiro) ao lado de `data`.
`400`	Requisição inválida — falha de validação.
`403`	Autenticado, mas sem permissão para esta operação.
`500`	Erro interno do servidor.

Exemple curl

curl -X GET "https://api.memberfy.net/api/events" \
  -H "X-CommunityId: $COMMUNITY_ID"