Référence API

Recherche publique par code

Trouve un candidat approuvé ou vote public par code ou slug selon la visibilité et les catégories actives.

GEThttps://sparkglim.net/api/participants/search

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
`code`Obligatoire Identifiant ou code requis par cet endpoint ; ne publiez jamais de vrai OTP ou secret de billet.	`string`	Validation : Code de candidat, participant ou campagne, ou segment URL de campagne ; q accepté comme alias.

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/participants/search

http

GET /api/participants/search?code=EXAMPLE HTTP/1.1
Host: sparkglim.net

Réponse

Réponse de succès · HTTP 200

json

{
  "success": true,
  "resultType": "nominee",
  "participant": {
    "id": "11111111-1111-4111-8111-111111111111",
    "name": "Example nominee",
    "bio": null,
    "category": null,
    "vote_count": null,
    "show_vote_count": false,
    "participant_code": "EXAMPLE",
    "nominee_code": null,
    "image_url": null
  },
  "campaign": {
    "id": "11111111-1111-4111-8111-111111111111",
    "title": "Example awards",
    "slug": "example-awards",
    "status": "approved",
    "campaign_type": "voting",
    "vote_price": 1,
    "image_url": null,
    "banner_url": null
  }
}

Réponse d’erreur · HTTP 400

json

{
  "error": "No nominee or digital voting campaign found for this code"
}

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

Limites et tentatives

Ce gestionnaire Web ne définit pas de limiteur dédié ; des contrôles en amont peuvent s’appliquer.

Compatibilité du code

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

app/api/participants/search/route.ts