Referencia API

Descubrimiento de campañas públicas

Busca índice público estricto por producto, país, período, lugar y fecha; devuelve paginación exacta y datos permitidos.

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

Modelo de acceso

Modelo de acceso: Acceso público con validación
Disponibilidad documentada: Implementado en código

Disponibilidad verificada en el código, sin garantía de producción.

Devuelva solo registros permitidos por cuenta, campaña y visibilidad.

Parámetros

Nombre	Tipo	Validación
`q`Opcional Texto buscado en título, descripción, organizador, ubicación o beneficiario públicos.	`string`	Validación: <=100.
`country`Opcional Filtro por país configurado de campaña; no habilita pagos ni convierte moneda.	`string`	Validación: ISO2.
`location`Opcional Ubicación pública o filtro; separado del país vendedor financiero.	`string`	Validación: <=100.
`type`Opcional Tipo de recurso, reacción o filtro de campaña admitido aquí.	`enum`	Validación: all \| ticketing \| voting \| donation.
`status`Opcional Estado admitido solicitado; aprobación controla publicación y acceso.	`enum`	Validación: all \| active \| upcoming \| ended \| postponed.
`sort`Opcional Selecciona orden del servidor: destacados, recientes o cierre.	`enum`	Validación: featured \| latest \| ending.
`date`Opcional Limita búsqueda a ventana de fecha documentada del filtro existente.	`enum`	Validación: all \| today \| tomorrow \| weekend \| month.
`page`Opcional Página solicitada según numeración documentada; conserve metadatos del servidor.	`integer`	Validación: 1–1000000.
`limit`Opcional Máximo de registros en la página; se aplica el límite fijo del endpoint.	`integer`	Validación: 1–24; valor predeterminado: 12.

Solicitud

Los ejemplos describen el contrato y no se ejecutan. Use registros de prueba autorizados; nunca pegue secretos reales aquí.

GET /api/public/homepage/discovery

http

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

Respuesta

Respuesta correcta · HTTP 200

json

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

Respuesta de error · HTTP 400

json

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

Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límites y reintentos

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Compatibilidad del código

Las operaciones autorizadas requieren pruebas específicas de la cuenta.

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