Referencia API

Búsqueda pública por código

Busca candidato aprobado o campaña pública por código o slug según visibilidad y categoría activa.

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

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
`code`Obligatorio Credencial o código requerido; nunca publique OTP real o secreto de entrada.	`string`	Validación: Código de candidato, participante o campaña, o identificador URL de campaña; se acepta q como alias.

Solicitud

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

GET /api/participants/search

http

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

Respuesta

Respuesta correcta · 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
  }
}

Respuesta de error · HTTP 400

json

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

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

Límites y reintentos

Este controlador web no define limitador propio; pueden existir controles previos.

Compatibilidad del código

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

app/api/participants/search/route.ts