Referência API

Verificação pública de bilhetes

Encaminha verificação da credencial ao leitor Web e mantém estado e resultado; não regista admissão.

GEThttps://api.sparkglim.net/api/public/tickets/public-verify

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.

Abra o URL de pagamento devolvido. O SparkGlim Server controla preços, métodos, verificação e entrega; o regresso do navegador apenas navega.

Trate códigos como credenciais. Pode mostrar dados após entrada; verificar não a autoriza.

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: Credencial de bilhete válida.

Pedido

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

GET /api/public/tickets/public-verify

http

GET /api/public/tickets/public-verify?code=EXAMPLE_TICKET_CREDENTIAL HTTP/1.1
Host: api.sparkglim.net

Resposta

Resposta de sucesso · HTTP 200

json

{
  "success": true,
  "data": {
    "ticket_code": "<TICKET_CODE>",
    "checked_in": false,
    "checked_in_at": null,
    "details_revealed": false,
    "campaign": {
      "title": "Example event",
      "slug": "example-event",
      "venue": "Example venue"
    },
    "ticket_name": "Example ticket"
  }
}

Resposta de erro · HTTP 400

json

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

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

Limites e novas tentativas

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Compatibilidade do código

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

server/src/api/router.ts
server/src/api/routes/public.ts