Milhas passageiro frequente

O preço das chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; a validação com falha não é cobrada.

Como as milhas ganhas são calculadas com tarifa, distância, taxa e status

Parta de uma tarifa publicada ou da distância conhecida de um trecho e da linguagem de acúmulo do guia do seu programa de passageiro frequente. No modo gasto, base_amount é a tarifa elegível do bilhete em unidades monetárias principais —muitas vezes a tarifa base sem impostos, ou o valor que o programa define como receita para o acúmulo— e earning_rate são milhas por unidade monetária, por exemplo cinco milhas por dólar em uma tarifa de cartão co-branded ou uma milha por euro em um bilhete de receita básico. No modo distância, base_amount é a distância voada em milhas estatutárias ou quilômetros (use uma única unidade de forma consistente) e earning_rate é a razão de acúmulo em decimal: um significa cem por cento da distância, zero vírgula cinco significa cinquenta por cento, e um vírgula cinco significa um bônus de classe de cento e cinquenta por cento já embutido na taxa. A calculadora multiplica base_amount por earning_rate para formar base_miles. Se você tem status elite ou um bônus de co-brand que anuncia um percentual extra sobre as milhas base, coloque essa cifra em status_bonus_percent —por exemplo cinquenta para mais cinquenta por cento— de modo que bonus_miles seja base_miles vezes o percentual dividido por cem e total_miles seja base_miles mais bonus_miles. De forma equivalente, total_miles é base_amount vezes earning_rate vezes um mais status_bonus_percent dividido por cem. Omitir status_bonus_percent define o padrão como zero, mantendo a estimativa sem elite honesta. Valores negativos, campos obrigatórios ausentes, números não finitos e cadeias de modo desconhecidas falham com invalid_input para que o cliente nunca veja NaN nem cortes silenciosos. Entradas idênticas sempre produzem o mesmo JSON: sem busca de tabelas na rede, sem ruído aleatório e sem dependência de relógio.

O que você envia e o que recebe de volta

Verificações clássicas incluem uma tarifa de quatrocentas unidades a cinco milhas por unidade com bônus de status de cinquenta por cento, que gera duas mil milhas base e três mil milhas totais, ou uma distância de duas mil e quinhentas unidades com acúmulo de cem por cento e bônus de vinte e cinco por cento, que gera duas mil e quinhentas milhas base e três mil cento e vinte e cinco no total. Conecte o formulário gratuito do navegador para o planejamento pontual de viagens e, em seguida, o mesmo contrato a partir de scripts quando você processar dezenas de tarifas candidatas contra a mesma tabela de taxas do programa. Envie base_amount e earning_rate como números finitos obrigatórios maiores ou iguais a zero. Opcionalmente envie status_bonus_percent como número finito não negativo, e mode como a string spend ou distance (aliases fare ou revenue para gasto, miles ou km para distância). Strings JSON que se interpretam como números são aceitas da mesma forma que literais numéricos. Se faltarem base_amount ou earning_rate, se houver strings vazias, NaN, Infinity, valores negativos ou mode inválido, a requisição falha com invalid_input e não é cobrada. Em caso de sucesso a resposta ecoa base_amount, earning_rate, status_bonus_percent e mode já limpos; informa base_unit como currency ou distance e rate_unit como miles_per_currency_unit ou accrual_ratio; e devolve base_miles, bonus_miles, total_miles, effective_multiplier igual a um mais o percentual de bônus dividido por cem, e uma string de fórmula legível. O preço das chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago. Ferramentas posteriores podem usar apenas total_miles como limiar, guardar o objeto completo para auditoria ou combinar o resultado com uma capacidade separada de valor em centavos por ponto ao decidir se gasta ou acumula em um itinerário.

Onde calculadoras de milhas de passageiro frequente aparecem no trabalho real

Equipes de onboarding de fidelidade usam o mesmo JSON em demos e sandboxes de API para que planilhas offline fiquem alinhadas com a produção. Como esta capacidade é um motor parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e a validação com falha não consome saldo.