AstroWay/api v2.173.1 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/ziwei/chart

Zi Wei Dou Shu (Purple Star) API

Une date de naissance, une heure et un sexe génèrent le tableau complet : douze palais avec leurs tiges, les quatorze étoiles principales, les auxiliaires, trente-une étoiles mineures, les douze étapes de vie, les limites décennales et les quatre transformations marquées sur les étoiles qui les portent.

Endpoint
POST /v1/ziwei/chart
Cost
20 credits
Latency
~130 ms
Tier
Tier 2
// 01 / What it computes

Zi Wei Dou Shu (Purple Star) API

La naissance est convertie en date lunaire, car Zi Wei est un système purement lunaire et, contrairement à BaZi, ne passe pas aux termes solaires. À partir du mois lunaire et de la double-heure, l'endpoint place le palais de l'âme et le palais du corps, puis applique la règle des cinq-tigres à chaque palais, puis lit la classe des cinq-éléments du pilier du palais de l'âme. Cette classe et le jour lunaire placent 紫微 selon la règle classique d'emprunt-et-division, les six étoiles de sa série suivent avec des décalages fixes, 天府 les reflète sur l'axe 寅-申 et porte ses propres huit. Au-dessus de ce squelette se superposent les six étoiles chanceuses et les six étoiles maléfiques, le magasin de salaire et le cheval céleste, trente-une étoiles mineures liées au tronc de l'année, à la branche de l'année, au mois, au jour et à l'heure, les douze étapes de vie, le cycle du savant, le cycle général et le cycle de l'année, les limites décennales ouvrant au class number, et la annual limit si tu demandes un age. Les four transformations sont résolues à partir du tronc de l'année et attachées aux étoiles elles-mêmes plutôt que retournées comme une liste détachée.

// 02 / Live request

POST/v1/ziwei/chart

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2000-08-16",
    "time": "04:00:00",
    "gender": "male",
    "age": 25
  }'
Response (excerpt)
{
  "ok": true,
  "data": {
    "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" }],
        "lifeStage": { "chinese": "死", "name": "Death" },
        "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date. It is converted to a lunar date, because Zi Wei is a lunar system.
time string (HH:MM:SS) yes Local clock time. Required: the soul palace is placed from the double-hour, so a chart without it would be twelve palaces of confident nonsense rather than a partial answer.
gender string yes male or female. It sets the direction of the twelve life stages, the scholar cycle and the decade limits, so the chart cannot be built without it.
age number no Return the annual-limit palace for this age. Omit and the field comes back null.
yearDivide string no lunar (default: the year opens on day one of the first lunar month) or lichun (the BaZi boundary, for reconciling against a calculator that imported it).
fixLeap boolean no Split a leap month at day 15 (default) or count the whole of it as the month it follows.
dayDivide string no forward (default: 23:00 belongs to the next day) or current (keep the date and mark the hour as the late Zi).
school string no The 四化 table: zhongzhou (default), quanji, quanshu or beipai. The four disagree on three of the ten year stems.
language string no Any of 21 codes. Palace names and life-stage names come back translated; star names stay as characters with an English gloss.
// 04 / When to use it

When to use it

Utilise-le quand tu construis un produit d'astrologie chinoise pour un marché qui lit autre chose que le chinois : une app, un service de lecture, un rendu de tableau, un agent qui a besoin de la structure avant d'interpréter. La réponse est une structure pure sans prose, donc elle s'intègre dans une grille à douze palais, un générateur de rapport ou un prompt LLM aussi bien. Les reference endpoints de la même famille sont moins chers et utiles pour les glossaires et les tooltips, mais ils renvoient la même table pour chaque naissance et l'indiquent dans un champ, donc ne construis pas de tableau à partir d'eux.

// 05 / Notes

Notes

Épinglé à trois tableaux publiés plutôt qu'à une bibliothèque, délibérément : presque tout l'écosystème open-source Zi Wei descend d'un seul projet, donc être d'accord avec plusieurs d'entre eux, c'est être d'accord avec un seul. Deux tableaux complets reproduisent exactement, et un troisième provient d'un texte d'enseignement indépendant. Quatre commutateurs d'école résident dans le request body plutôt que dans notre code, car chacun déplace le tableau complet pour les naissances qu'il touche : la limite d'année, le mois intercalaire, le basculement à 23 h00 et la table de transformation. Quand un autre calculateur n'est pas d'accord, vérifie ces quatre avant l'arithmétique.

Try the Zi Wei Dou Shu API

Grab a key and make your first call in under a minute.

99,9% SLA · forfaits payants · 30 j statut →