Referência API

Descoberta de campanhas públicas

Pesquisa índice público estrito por produto, país, período, local e data; devolve paginação exata e dados permitidos.

GEThttps://api.sparkglim.net/api/public/homepage/discovery

Modelo de acesso

Modelo de acesso: Acesso público com validação
Disponibilidade documentada: Implementado no código

Disponibilidade verificada no código, sem garantia de produção.

Devolva apenas registos permitidos por conta, campanha e visibilidade.

Parâmetros

Nome	Tipo	Validação
`q`Opcional Texto pesquisado em título, descrição, organizador, local ou beneficiário públicos.	`string`	Validação: <=100.
`country`Opcional Filtro pelo país configurado da campanha; não ativa pagamentos nem converte moeda.	`string`	Validação: ISO2.
`location`Opcional Local público ou filtro; separado do país financeiro de venda.	`string`	Validação: <=100.
`type`Opcional Tipo de recurso, reação ou filtro de campanha suportado aqui.	`enum`	Validação: all \| ticketing \| voting \| donation.
`status`Opcional Estado suportado pedido; aprovação controla publicação e acesso.	`enum`	Validação: all \| active \| upcoming \| ended \| postponed.
`sort`Opcional Seleciona ordem do servidor: destaques, recentes ou fecho.	`enum`	Validação: featured \| latest \| ending.
`date`Opcional Limita pesquisa à janela de data documentada do filtro existente.	`enum`	Validação: all \| today \| tomorrow \| weekend \| month.
`page`Opcional Página pedida conforme numeração documentada; preserve metadados do servidor.	`integer`	Validação: 1–1000000.
`limit`Opcional Máximo de registos na página; aplica-se o limite fixo do endpoint.	`integer`	Validação: 1–24; valor predefinido: 12.

Pedido

Os exemplos descrevem o contrato e não são executados. Use registos de teste autorizados; nunca cole segredos reais aqui.

GET /api/public/homepage/discovery

http

GET /api/public/homepage/discovery HTTP/1.1
Host: api.sparkglim.net

Resposta

Resposta de sucesso · HTTP 200

json

{
  "success": true,
  "data": {
    "entries": [],
    "countries": [],
    "locations": [],
    "pagination": {
      "page": 1,
      "limit": 12,
      "total": 0,
      "pages": 0,
      "hasMore": false
    },
    "available": true
  }
}

Resposta de erro · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limites e novas tentativas

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Compatibilidade do código

As operações autorizadas exigem testes específicos da conta.

server/src/api/routes/public-homepage.ts