Ir para a documentação
SparkGlimSparkGlim Programadores
Pesquisar em toda a documentação

Experimente um tema na sua língua ou um caminho API exato.

    Referência API

    Validar desconto

    Valida desconto existente pelo contrato partilhado; compra verifica preço final e elegibilidade.

    POSThttps://api.sparkglim.net/api/public/discounts/validate

    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

    NomeTipoValidação
    codeObrigatório

    Credencial ou código exigido; nunca publique OTP real ou segredo de bilhete.

    stringValidação: Desconto de campanha existente.
    campaign_idObrigatório

    Campanha existente na conta e no âmbito mais limitado de qualquer credencial de campanha.

    stringValidação: Identificador de campanha.
    phone_numberOpcional

    Telefone do participante; métodos e regras podem exigir número internacional válido.

    stringValidação: Telefone do cliente.
    emailOpcional

    Email de contacto usado pelo fluxo configurado; por si só não concede acesso.

    stringValidaçã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
    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

    Resposta de sucesso · HTTP 200
    json
    {
      "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"
      }
    }
    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/routes/public.ts
    • app/api/discounts/validate/route.ts