Referência API

Iniciar compra de bilhetes

Valida bilhete, quantidade, comprador e proteção do navegador; devolve pagamento do servidor ou resultado gratuito.

POSThttps://api.sparkglim.net/api/public/tickets/purchase

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.

Pedido

Nome	Tipo	Validação
`campaign_id`Obrigatório Campanha existente na conta e no âmbito mais limitado de qualquer credencial de campanha.	`string`	Validação: UUID.
`ticket_id`Obrigatório Tipo de bilhete escolhido da campanha indicada; o servidor verifica estado, capacidade e preço.	`string`	Validação: UUID.
`quantity`Obrigatório Número de bilhetes; o servidor impõe inventário e limites por pessoa.	`integer`	Validação: 1–100.
`phone_number`Obrigatório Telefone do participante; métodos e regras podem exigir número internacional válido.	`string`	Validação: Telefone válido e não vazio.
`email`Opcional Email de contacto usado pelo fluxo configurado; por si só não concede acesso.	`string`	Validação: Endereço de e-mail.
`discount_code`Opcional Código de desconto ou convite da campanha, revalidado antes da compra.	`string`	Validação: Valor sem espaços nas extremidades e não vazio.
`invite_code`Opcional Código de desconto ou convite da campanha, revalidado antes da compra.	`string`	Validação: Valor sem espaços nas extremidades e não vazio.
`luggage_quantity`Opcional Quantidade de bagagem para evento que suporta essa opção configurada.	`integer`	Validação: >=0.
`attendee_information`Opcional Respostas aos campos reais da campanha, valores exigidos e opções suportadas.	`object`	Validação: Valores de texto correspondentes aos campos configurados.
`payment_channel`Opcional Preferência opcional; só se usam métodos ativos para país de venda, moeda e comerciante reais.	`enum`	Validação: card \| mobile_money \| apple_pay \| bank_transfer \| crypto; disponibilidade controlada pelo servidor.
`network_code`Opcional Rede móvel configurada quando o método de pagamento a exige.	`string`	Validação: Rede configurada.
`is_app`Opcional Contexto existente para escolher configuração Web ou App; sem permissões extra.	`boolean`	Validação: Contexto do cliente.
`web_abuse_context`Obrigatório Dados existentes de proteção do navegador exigidos antes do pagamento público; não substituem autorização do servidor.	`object`	Validação: Objeto estrito; JSON de device_details <=12000 caracteres.
`web_abuse_context.device_id`Obrigatório Sinal existente de proteção do navegador aceite pelo esquema atual.	`string`	Validação: 12–160.
`web_abuse_context.device_fingerprint`Obrigatório Sinal existente de proteção do navegador aceite pelo esquema atual.	`string`	Validação: 12–160.
`web_abuse_context.browser_signature`Opcional Sinal existente de proteção do navegador aceite pelo esquema atual.	`string\|null`	Validação: 12–160.
`web_abuse_context.hardware_signature`Opcional Sinal existente de proteção do navegador aceite pelo esquema atual.	`string\|null`	Validação: 12–160.
`web_abuse_context.device_details`Opcional Sinal existente de proteção do navegador aceite pelo esquema atual.	`object`	Validação: Objeto JSON.
`web_abuse_context.client_pattern_detected`Opcional Sinal existente de proteção do navegador aceite pelo esquema atual.	`boolean`	Validação: Proteção de dispositivo existente.
`client_attempt_id`Opcional Identificador estável usado para recuperar uma tentativa e rejeitar repetições incompatíveis.	`string`	Validação: Identidade de operação normalizada e estável.
`return_path`Opcional Destino relativo de regresso ao site atual verificado após pagamento central.	`string`	Validação: Caminho relativo da mesma origem; sem // nem barra invertida.

Pedido

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

POST /api/public/tickets/purchase

http

POST /api/public/tickets/purchase HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json

{
  "campaign_id": "11111111-1111-4111-8111-111111111111",
  "ticket_id": "22222222-2222-4222-8222-222222222222",
  "quantity": 1,
  "phone_number": "+233200000000",
  "web_abuse_context": {
    "device_id": "<EXISTING_DEVICE_ID>",
    "device_fingerprint": "<EXISTING_DEVICE_FINGERPRINT>"
  },
  "client_attempt_id": "example_stable_attempt_0001"
}

Resposta

Resposta de sucesso · HTTP 200

json

{
  "success": true,
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "pending"
  }
}

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

Modelo de acesso

Pedido

Pedido

Resposta

Limites e novas tentativas

Compatibilidade do código

Continuar a desenvolver