Référence API

Découverte des campagnes publiques

Recherche l’index public strict avec produit, pays, période, lieu et dates, puis retourne pagination exacte et données autorisées.

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

Modèle d’accès

Modèle d’accès: Accès public avec validation
Disponibilité documentée: Implémenté dans le code

La disponibilité est vérifiée dans le code, pas garantie en production.

Ne retournez que les données autorisées par le compte, la campagne et la visibilité.

Paramètres

Nom	Type	Validation
`q`Facultatif Texte recherché dans titre, description, organisateur, lieu et bénéficiaire publics applicables.	`string`	Validation : <=100.
`country`Facultatif Filtre sur le pays configuré de la campagne ; n’active aucun paiement et ne convertit pas de devise.	`string`	Validation : ISO2.
`location`Facultatif Lieu public ou filtre de lieu ; distinct du pays de vente financier.	`string`	Validation : <=100.
`type`Facultatif Type de ressource, réaction ou filtre de campagne pris en charge ici.	`enum`	Validation : all \| ticketing \| voting \| donation.
`status`Facultatif État de cycle pris en charge ; les règles d’approbation contrôlent encore publication et accès.	`enum`	Validation : all \| active \| upcoming \| ended \| postponed.
`sort`Facultatif Sélectionne l’ordre serveur : mise en avant, nouveauté ou clôture.	`enum`	Validation : featured \| latest \| ending.
`date`Facultatif Limite la recherche à la période documentée du filtre serveur existant.	`enum`	Validation : all \| today \| tomorrow \| weekend \| month.
`page`Facultatif Page demandée selon la numérotation documentée ; conservez la pagination serveur.	`integer`	Validation : 1–1000000.
`limit`Facultatif Nombre maximum de données dans cette page ; la borne fixe de l’endpoint s’applique.	`integer`	Validation : 1–24 ; valeur par défaut : 12.

Requête

Les exemples décrivent le contrat et ne sont pas exécutés. Utilisez des données de test autorisées ; ne saisissez jamais de secret réel ici.

GET /api/public/homepage/discovery

http

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

Réponse

Réponse de succès · HTTP 200

json

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

Réponse d’erreur · HTTP 400

json

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

Validation, permissions, données indisponibles et pannes utilisent le statut HTTP et l’erreur du gestionnaire.

Limites et tentatives

Limite serveur par défaut : 100 requêtes par IP sur 60 secondes. Des contrôles spécifiques s’appliquent.

Compatibilité du code

Les opérations autorisées nécessitent des tests propres au compte.

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