Masse, rayon et luminosité solaires

Les noms d’unité inconnus et les demandes entre grandeurs différentes échouent avec une erreur invalid_input claire et ne sont pas facturés. L’algorithme est une arithmétique pure, sans réseau, sans graine aléatoire et sans horloge, de sorte que des entrées identiques produisent toujours le même JSON pour les tests et les pipelines.

Choisir value, from et to pour les unités solaires et SI

Envoyez un objet JSON avec trois champs obligatoires : value (nombre fini ; alias amount et quantity), from (unité source ; alias unit_from et source) et to (unité cible ; alias unit_to et target). Les chaînes d’unité sont insensibles à la casse ; espaces, tirets bas et traits d’union se réduisent à la même table d’alias, de sorte que M_sun, solar-mass et Msun se résolvent en masse solaire.

Lire le résultat, l’intermédiaire SI et les contrôles de grandeur

Le champ result est la grandeur convertie dans l’unité cible, arrondie à douze décimales pour des goldens stables et l’affichage interface. Factor indique combien d’unités cibles valent une unité source à l’échelle donnée, et formula reformule le chemin multiplier-et-diviser pour l’enseignement et les journaux de débogage. Units_supported énumère chaque jeton canonique par famille. Les échecs de validation ne consomment jamais le solde prépayé une fois la requête rejetée par le moteur. En cas de succès, la réponse renvoie value, from et to avec des from_label et to_label lisibles, plus dimension valant mass, radius ou luminosity. Le champ si est la quantité intermédiaire dans la base SI de cette grandeur—kilogrammes pour la masse, mètres pour le rayon, watts pour la luminosité—et si_unit nomme cette base. Method vaut toujours solar_units_iau2015 afin que le code en aval puisse brancher sans inspecter la forme. Si from et to appartiennent à des grandeurs différentes—par exemple Msun vers Rsun—le moteur lève invalid_input avec un message d’incompatibilité de grandeur plutôt que d’inventer une conversion absurde. Les jetons inconnus lèvent invalid_input en nommant la mauvaise unité et en listant les familles prises en charge. L’absence de value, from ou to échoue de la même manière.

Tarification API, usage navigateur et flux pratiques

Appelez le convertisseur gratuit de masse et de rayon solaires dans le navigateur pour les contrôles de devoirs, les démonstrations de cours et les vérifications rapides de catalogue sans installer Astropy ni une table locale de constantes. Associez ce point d’accès à des calculateurs d’années-lumière ou orbitaux lorsque l’étape suivante est la modélisation dynamique plutôt que la seule conversion d’unités. Utilisez l’API prépayée lorsqu’un pipeline d’exoplanètes, un service d’isochrones stellaires, une plateforme de tutorat ou un carnet de recherche a besoin d’un contrat stable sous solde KIT à $0.002 par élément réussi. Gardez les entrées dans des ordres de grandeur flottants ordinaires ; des exposants extrêmes peuvent perdre de la précision en arithmétique IEEE double, comme toute calculatrice du navigateur. Les auteurs de SDK peuvent mapper result, si et dimension vers des tableaux d’interface qui reflètent ce que les étudiants écrivent à la main lorsqu’ils convertissent une masse solaire en kilogrammes ou une luminosité solaire en watts.