Zi Wei Dou Shu : placement des étoiles

Zi Wei Dou Shu ne construit pas une carte à partir de planètes, mais à partir de douze palais et d’une centaine d’étoiles, disposés selon des règles basées sur la date lunaire et l’heure de naissance. POST /v1/ziwei/chart calcule cela entièrement.

Endpoints

Endpoint	Crédits	Ce que ça retourne
POST /v1/ziwei/chart	20	Carte complète : palais, étoiles, phases, limites, 四化. Nécessite time et gender
POST /v1/ziwei/four-transformations	10	四化 selon la tige annuelle, quatre écoles
POST /v1/ziwei/twelve-palaces	5	Référence des douze palais
POST /v1/ziwei/main-stars	5	Référence des quatorze étoiles principales
POST /v1/ziwei/palace-*	5	Référence d’un palais, neuf chemins

Les routes de référence contiennent le champ computed: false et coûtent la moitié du tarif. Elles renvoient la même table pour n’importe quelle date de naissance, et il n’y a rien de mal à cela tant que c’est spécifié.

`/ziwei/full-chart` est déprécié

Il renvoie le même dictionnaire de palais à tout le monde, alors que son nom promet une carte. Il répondra sans changement jusqu’au 2027-11-26, et inclura les en-têtes Deprecation, Sunset et Link vers son successeur. Passe à /v1/ziwei/chart : il nécessite gender en plus de la date et de l’heure.

Exemple

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'

{
  "fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
  "soulPalace": { "index": 4, "branch": "Wu" },
  "bodyPalace": { "index": 8, "branch": "Xu" },
  "ziwei": { "index": 4, "branch": "Wu" },
  "annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
  "palaces": [
    {
      "branch": "Wu",
      "pillar": "Ren-Wu",
      "palace": "destiny",
      "isSoul": true,
      "majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei", "kind": "major" }],
      "lifeStage": { "chinese": "死", "name": "Death", "localised": "Death" },
      "boshi": "伏兵",
      "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
    }
  ]
}

Le tableau palaces contient les douze palais sous la même forme, de 寅 à 丑.

Ce qui est calculé

Étape	Règle
命宮 et 身宮	À partir du palais du mois, en arrière par les heures pour la Vie, en avant pour le Corps
Tiges des palais	五虎遁 à partir de la tige annuelle
五行局	À partir du pilier du palais de la Vie ; coïncide avec 納音 sur les soixante paires
紫微	Division du jour par le nombre de 局 avec emprunt : emprunt pair en avant, impair en arrière
紫微系 (6)	Décalage de −1, −3, −4, −5, −8 par rapport à 紫微
天府系 (8)	天府 est le miroir de 紫微 autour de l’axe 寅-申, puis +1..+6 et +10 pour 破軍
六吉 et 六煞	À partir du mois, de l’heure et de la tige annuelle, chacun avec sa propre formule
Trente et une petites étoiles	À partir de la branche annuelle, de la tige annuelle, du mois, du jour et de l’heure
長生十二神	À partir de 五行局, en avant pour 陽男陰女 et en arrière sinon
博士十二神	À partir de 祿存, même direction
將前 et 歲前 十二神	À partir du trio de la branche annuelle et de la branche elle-même, les deux toujours en avant
大限	À partir de 命宮, début à l’âge du nombre de 局, pas de dix ans
小限	Lit le sexe et ne lit pas le yin-yang, contrairement aux limites décennales
四化	Selon la tige annuelle, marquées directement sur les étoiles

Quatre commutateurs d’école

Ils se trouvent dans le corps de la requête, et non dans notre code, car chacun d’eux décale entièrement la carte pour les naissances qu’il affecte.

Paramètre	Par défaut	Deuxième valeur
yearDivide	lunar : l’année commence le premier jour du premier mois lunaire	lichun : limite de BaZi
fixLeap	true : le mois bissextile est divisé par le quinzième jour	false : tout le mois bissextile est compté comme le précédent
dayDivide	forward : 23:00 appartient au jour suivant	current : la date reste, l’heure est marquée comme 晚子時
tianmaSchool	year : 天馬 de la branche annuelle (中州派)	month : 天馬 du mois lunaire
school	zhongzhou : 四化 selon le corpus de 王亭之	quanji, quanshu, beipai

L'heure de naissance est obligatoire

Le palais de la Vie est déterminé par l’heure, et de lui dépendent le 五行局 et chaque étoile. Une carte sans heure ne serait pas une réponse partielle, mais douze palais d’absurdités certaines. C’est pourquoi une requête sans time est rejetée avec un 400. Cela diffère de BaZi, où sans heure, il n’y a tout simplement pas de pilier horaire.

Heure solaire vraie

Par défaut, l’heure est lue selon l’horloge locale, comme la plupart des praticiens la lisent. Transmets trueSolarTime: true avec longitude et timezoneOffset pour que l’heure soit lue selon le soleil au-dessus du lieu de naissance, avec la même correction que dans /v1/bazi. En Espagne ou dans l’ouest de la France, la différence est de 50 à 135 minutes, ce qui est suffisant pour que l’heure change, et avec elle le palais de la Vie et chaque étoile. La correction s’applique à l’heure et au jour ; avec yearDivide=lichun, la limite Lichun reste selon l’horloge. Ce qui a été appliqué est renvoyé dans input.trueSolarTime. longitude sans trueSolarTime ne change rien, et trueSolarTime sans longitude ou timezoneOffset renvoie un 400 TRUE_SOLAR_TIME_NEEDS_PLACE.

L'année ne commence pas ici avec Lichun

Ce n’est pas un choix d’école. 斗數 est un système purement lunaire et ne passe pas aux termes solaires, contrairement à 子平. yearDivide=lichun existe uniquement pour la vérification avec un calculateur qui a introduit la limite de BaZi.

Comment cela a été vérifié

C’est épinglé à trois cartes publiées, et non à une seule bibliothèque, et c’est intentionnel. Presque tout l’écosystème Zi Wei open source provient d’un seul projet : deux ports plus au moins un projet qui revendique une autre lignée, mais qui l’appelle en interne et analyse sa sortie. Par conséquent, une correspondance avec plusieurs projets est une correspondance avec un seul.

• Deux cartes sont entièrement reproduites : les quatorze étoiles principales, le 五行局, les palais de la Vie et du Corps.
• Les douze phases sont vérifiées sur un troisième vecteur de fixture de la même source où les douze attendues sont publiées, et non sur ces deux-là. Les débuts des décennies sont vérifiés avec le nombre de 五行局, c’est-à-dire avec la règle dont elles sont dérivées, et non avec une publication externe.
• Une troisième carte est tirée d’un texte d’enseignement chinois sans rapport avec cet écosystème et épingle indépendamment le décalage des étoiles et l’ordre des palais.
• La mnémotechnique 安紫微星 「六五四三二／酉午亥辰丑」 et le parcours publié de 火六局 sur les jours 1-15 sont vérifiés directement : ce sont des constantes de la tradition, et non une implémentation de quelqu’un.

Que faire si ton calculateur donne un résultat différent

Vérifie non pas l’arithmétique, mais les quatre commutateurs : la limite de l’année, le mois bissextile, la limite du jour à 23:00 et la table des 四化. Presque toujours, les divergences se trouvent là.

Une interprétation courante qui est incorrecte

火星 et 鈴星 sont placés en avant du trio de la branche annuelle et ne lisent pas le sexe dans aucune transmission vérifiée. La règle 陽男陰女順 / 陰男陽女逆, qui leur est parfois attribuée, appartient aux douze phases 長生十二神 et aux limites décennales. Les deux sujets se trouvent sur la même page dans la source la plus fréquemment copiée, et il semble que la confusion vienne de là.

Langues

Les noms des palais et des douze phases sont traduits en 21 langues : ajoute ?lang=, et chaque palais aura palaceLocalised, et chaque phase aura le champ localised. Les noms des étoiles restent des idéogrammes avec une traduction anglaise à côté : elles n’ont pas de noms établis.