Miles voyageur fréquent

Le prix des appels API réussis est la base publiée de $0.002 par élément ; l'échec de validation n'est pas facturé.

Comment les miles gagnés sont calculés à partir du tarif, de la distance, du taux et du statut

Partez d'un tarif publié ou d'une distance de segment connue et du langage d'accumulation du guide de votre programme de voyageur fréquent. En mode dépense, base_amount est le tarif éligible du billet en unités monétaires majeures — souvent le tarif de base hors taxes, ou le montant que le programme définit comme revenu pour l'accumulation — et earning_rate est le nombre de miles par unité monétaire, par exemple cinq miles par dollar sur un tarif de carte co-marque ou un mile par euro sur un billet de revenu basique. En mode distance, base_amount est la distance parcourue en miles statutaires ou en kilomètres (utilisez une seule unité de façon cohérente) et earning_rate est le ratio d'accumulation en décimal : un signifie cent pour cent de la distance, zéro virgule cinq signifie cinquante pour cent, et un virgule cinq un bonus de classe de cent cinquante pour cent déjà intégré au taux. Le calculateur multiplie base_amount par earning_rate pour former base_miles. Si vous détenez un statut élite ou un bonus co-marque qui annonce un pourcentage supplémentaire sur les miles de base, placez ce chiffre dans status_bonus_percent — par exemple cinquante pour plus cinquante pour cent — de sorte que bonus_miles égale base_miles multiplié par le pourcentage divisé par cent et total_miles égale base_miles plus bonus_miles. De façon équivalente, total_miles égale base_amount multiplié par earning_rate multiplié par un plus status_bonus_percent divisé par cent. Omettre status_bonus_percent le fixe à zéro par défaut afin que l'estimation hors élite reste honnête. Montants négatifs, champs obligatoires manquants, nombres non finis et chaînes de mode inconnues échouent avec invalid_input pour que le client ne voie jamais NaN ni des tronques silencieuses. Des entrées identiques produisent toujours le même JSON : sans téléchargement de barèmes sur le réseau, sans bruit aléatoire et sans dépendance à l'horloge.

Ce que vous envoyez et ce que vous recevez

Vérifications classiques : un tarif de quatre cents unités à cinq miles par unité avec un bonus de statut de cinquante pour cent produit deux mille miles de base et trois mille miles au total ; ou une distance de deux mille cinq cents unités à cent pour cent d'accumulation avec un bonus de vingt-cinq pour cent produit deux mille cinq cents miles de base et trois mille cent vingt-cinq au total. Reliez le formulaire gratuit du navigateur pour une planification ponctuelle, puis le même contrat depuis des scripts lorsque vous traitez des dizaines de tarifs candidats face à la même table de taux du programme. Envoyez base_amount et earning_rate comme nombres finis obligatoires supérieurs ou égaux à zéro. Envoyez éventuellement status_bonus_percent comme nombre fini non négatif, et mode comme la chaîne spend ou distance (alias fare ou revenue pour la dépense, miles ou km pour la distance). Les chaînes JSON qui s'interprètent comme des nombres sont acceptées comme les littéraux numériques. L'absence de base_amount ou earning_rate, les chaînes vides, NaN, Infinity, les valeurs négatives et un mode invalide échouent avec invalid_input et ne sont pas facturés. En cas de succès, la réponse renvoie base_amount, earning_rate, status_bonus_percent et mode nettoyés ; indique base_unit comme currency ou distance et rate_unit comme miles_per_currency_unit ou accrual_ratio ; et renvoie base_miles, bonus_miles, total_miles, effective_multiplier égal à un plus le pourcentage de bonus divisé par cent, et une chaîne de formule lisible. Le prix des appels API réussis est la base publiée de $0.002 par élément ; les échecs de validation ne consomment pas le solde prépayé. Les outils en aval peuvent seuiller sur total_miles seul, stocker l'objet complet pour audit, ou combiner le résultat avec une capacité séparée de valorisation en cents par point pour décider de brûler ou d'accumuler sur un itinéraire donné.

Où les calculateurs de miles de voyageur fréquent interviennent dans le travail réel

Les équipes d'intégration fidélité utilisent le même JSON dans les démos et les sandboxes API pour que les feuilles hors ligne restent alignées avec la production. Comme cette capacité est un moteur parse pur, le prix de l'API est la base publiée de $0.002 par élément réussi et l'échec de validation ne consomme pas le solde.