Referência API

Pesquisa pública por código

Procura nomeado aprovado ou campanha pública por código ou slug conforme visibilidade e categoria ativa.

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

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
`code`Obrigatório Credencial ou código exigido; nunca publique OTP real ou segredo de bilhete.	`string`	Validação: Código de nomeado, participante ou campanha, ou identificador URL de campanha; q aceite como alias.

Pedido

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

GET /api/participants/search

http

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

Resposta

Resposta de sucesso · 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
  }
}

Resposta de erro · HTTP 400

json

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

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

Limites e novas tentativas

Este controlador Web não define limitador próprio; podem existir controlos anteriores.

Compatibilidade do código

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

app/api/participants/search/route.ts