Referência API
Validar desconto
Valida desconto existente pelo contrato partilhado; compra verifica preço final e elegibilidade.
https://api.sparkglim.net/api/public/discounts/validateModelo 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 |
|---|---|---|
codeObrigatórioCredencial ou código exigido; nunca publique OTP real ou segredo de bilhete. | string | Validação: Desconto de campanha existente. |
campaign_idObrigatórioCampanha existente na conta e no âmbito mais limitado de qualquer credencial de campanha. | string | Validação: Identificador de campanha. |
phone_numberOpcionalTelefone do participante; métodos e regras podem exigir número internacional válido. | string | Validação: Telefone do cliente. |
emailOpcionalEmail de contacto usado pelo fluxo configurado; por si só não concede acesso. | string | Validação: Endereço de e-mail. |
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/discounts/validate HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json
{
"code": "<EXISTING_DISCOUNT>",
"campaign_id": "11111111-1111-4111-8111-111111111111"
}Resposta
{
"success": true,
"discount": {
"id": "11111111-1111-4111-8111-111111111111",
"code": "<EXISTING_DISCOUNT>",
"name": "Example discount",
"discount_percent": 10,
"campaign_id": "11111111-1111-4111-8111-111111111111"
}
}{
"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/routes/public.tsapp/api/discounts/validate/route.ts