ForHosting KIT · Outils pour développeurs

Convertisseur de numération maya en points et barres

Le convertisseur de numération maya transforme un entier décimal positif ou nul en une représentation claire en base vingt, composée de points, de barres et du symbole de coquille pour le zéro.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le résultat énumère chaque rangée positionnelle, de la puissance de vingt la plus élevée jusqu’aux unités. Il convient ainsi à l’enseignement, à la vérification d’un exercice manuscrit ou au dessin d’un nombre personnalisé. Chaque rangée indique sa puissance, la valeur du chiffre et ses éléments symboliques. La conversion est déterministe et privée dans le navigateur ; chaque requête automatisée à l’API coûte $0.002.

Lisez un nombre maya comme une valeur en base vingt

La numération maya repose sur une notation positionnelle, comme notre numération décimale, mais chaque position vaut vingt fois celle qui se trouve en dessous. La rangée inférieure, la moins significative, représente les unités ; la suivante représente les groupes de vingt, puis viennent les groupes de quatre cents, et ainsi de suite. Ce convertisseur renvoie les rangées dans l’ordre courant des formats de données : la plus significative en premier et les unités en dernier. La liste se traite donc facilement de gauche à droite tout en conservant la relation verticale du nombre écrit. Dans une rangée, un point vaut un et une barre vaut cinq. Les valeurs de un à dix-neuf associent au maximum trois barres et quatre points. Le zéro prend la forme d’une coquille afin qu’une position vide reste visible. Le champ power précise la puissance de vingt occupée, value fournit le chiffre de zéro à dix-neuf et symbols contient les éléments nécessaires pour le dessiner ou le décrire sans devoir retrouver sa décomposition.

Choisissez et validez la valeur décimale

Saisissez un seul champ nommé number contenant un entier JSON supérieur ou égal à zéro. Le zéro est valide et produit une rangée avec une coquille ; il ne donne jamais un résultat vide. Les nombres négatifs sont refusés, car cette représentation est réservée ici aux entiers positifs ou nuls. Les fractions, le texte numérique tel que "429", les valeurs absentes, les infinis et les nombres hors de la plage des entiers sûrs de JavaScript sont également rejetés au lieu d’être arrondis ou réinterprétés en silence. Cette rigueur est essentielle lorsqu’une conversion doit être notée, enregistrée ou servir à créer une illustration : une valeur qui paraît seulement numérique ne doit pas devenir un autre nombre par accident. Une réponse valide répète le nombre initial, indique la base vingt et fournit les rangées de la puissance la plus élevée à la plus faible. Toutes les positions sont conservées, y compris un zéro intermédiaire, puisque retirer une coquille entre deux rangées non nulles modifierait la valeur. Vous pouvez ainsi contrôler automatiquement la structure ou recopier les symboles selon des règles prévisibles.

Dessinez, vérifiez et réutilisez les rangées obtenues

Pour afficher le résultat dans le style vertical traditionnel, placez en haut la première rangée renvoyée, puis descendez dans l’ordre de la liste. Dans chaque rangée non nulle, dessinez les points au-dessus des barres. La liste symbols fournit d’abord un jeton regroupant les points lorsqu’ils sont nécessaires, puis un jeton de barre pour chaque groupe de cinq ; la coquille est l’unique symbole du zéro. Le champ value facilite les libellés accessibles et le débogage, tandis que power permet d’indiquer les valeurs de position à côté d’un schéma pédagogique. Vérifiez la conversion en multipliant la valeur de chaque rangée par vingt élevé à sa puissance, puis en additionnant les produits : la somme doit être égale à number. L’algorithme emploie uniquement la division entière et les restes, sans réseau, hasard, horloge, règle régionale ni état mutable. Une même entrée produit donc toujours le même JSON. Cette stabilité convient aux fiches scolaires, dispositifs de musée, compilations de sites statiques et outils de création. Le navigateur suffit aux conversions ponctuelles, et l’API coûte $0.002 par requête automatisée.

Préparez un exemple de cours

Transformez la valeur décimale d’un exercice en rangées positionnelles que les élèves peuvent dessiner et vérifier.

Créez une œuvre en chiffres historiques

Employez les points, barres et coquilles ordonnés comme données déterministes pour une composition visuelle.

Contrôlez une conversion manuelle

Comparez des chiffres en base vingt écrits à la main aux valeurs et puissances renvoyées.

Quelles entrées sont acceptées ?

Le champ number doit contenir un entier JSON positif ou nul appartenant à la plage des entiers sûrs.

Comment le zéro est-il représenté ?

Le zéro renvoie une rangée d’unités de valeur nulle dont la liste symbols contient une coquille.

Quelle rangée apparaît en premier ?

Les rangées vont de la plus grande puissance de vingt à la puissance zéro ; la plus significative vient en premier.

L’ajustement calendaire du Compte long est-il appliqué ?

Non. La conversion utilise une base vingt pure, sans valeurs de position propres au calendrier.

Quel est le prix d’une conversion par API ?

Chaque requête à l’API coûte $0.002 ; l’outil du navigateur exécute localement la même conversion déterministe.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/math/mayan-numeral

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/math/mayan-numeral \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":429}'
{
  "number": 429
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.mayan_numeral",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →