API BaZi (Quatre Piliers)
Un moment de naissance transformé en l'appareil classique complet : les quatre piliers, les troncs que chaque branche abrite, le na yin, les douze étapes de la vie, l'équilibre des éléments sur les huit caractères, un verdict de force selon un cadre nommé, les étoiles symboliques, et les interactions entre branches et troncs. Un appel, JSON en sortie, 21 langues.
API BaZi (Quatre Piliers)
L'endpoint résout la naissance aux instants exacts de Li Chun et 節 à partir de l'éphéméride plutôt que d'une table de dates, de sorte qu'une naissance à moins d'un jour d'une limite tombe dans la bonne année et le bon mois. Le jour et l'heure suivent l'horloge du lieu de naissance et changent à 23h00. À partir de ces quatre piliers, il ouvre les branches : un à trois troncs cachés chacun, avec le rôle et le poids que la tradition leur accorde, c'est là que vivent la plupart des éléments d'un thème. Il dérive ensuite le na yin de chaque pilier, l'étape du maître du jour par rapport à chaque branche, trois comptages d'éléments distincts, la lecture de force 扶抑 avec ses trois critères classiques rapportés non pondérés, les six étoiles symboliques calculées à partir du pilier de référence de l'année et du jour, et chaque combinaison, conflit, dommage et punition présents.
POST/v1/bazi/chart
curl -X POST https://api.astroway.info/v1/bazi/chart \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 8,
"language": "en"
}'{
"ok": true,
"data": {
"solarYear": 1990,
"pillars": [
{ "name": "year", "pillar": "Geng-Wu", "animalName": "Horse", "stemElementName": "Metal" },
{ "name": "month", "pillar": "Xin-Si", "animalName": "Snake", "stemElementName": "Metal" }
],
"dayMaster": { "stem": "Geng", "element": "Metal", "polarity": "Yang" },
"elementBalance": {
"weighted": { "Wood": 0.4, "Fire": 1.6, "Earth": 1.6, "Metal": 3.3, "Water": 1.1 },
"missingElements": []
},
"strength": { "verdict": "strong", "supportRatio": 0.557, "hasSeason": false, "hasRoot": true },
"symbolicStars": { "byDayPillar": [ { "english": "Canopy", "pillars": ["day"] } ] },
"interactions": [ { "english": "Six Harmony", "members": ["Wu","Wei"], "producesElement": "Earth" } ]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | no | Local clock time at birth. Without it there is no hour pillar and the analysis runs on six characters, which every field of the response says. |
| timezoneOffset | number (hours) | no | The UTC offset the clock was actually running on. A 1988 Beijing birth ran on +9 under summer time; no arithmetic recovers that from the date. |
| longitude | number | no | Birth longitude, east positive. Inert unless trueSolarTime is set. |
| trueSolarTime | boolean | no | Cut the double-hour from the sun over the birth place. Reaches the day and hour only: the year and month turn on world instants. |
| stageSchool | string | no | classical (陽順陰逆, default) or unified (陰陽同生同死) for the twelve life stages. |
| language | string | no | Any of 21 codes. Animals, elements, polarity and stage names come back translated; stems and branches stay in pinyin. |
When to use it
Utilise ceci au lieu de sept allers-retours lorsque tu rends un thème. Les endpoints à usage unique existent à côté pour quand tu veux une seule table. Si tes utilisateurs sont nés loin du méridien de leur zone, passe la longitude avec trueSolarTime : la Chine couvre une zone de soixante degrés et une naissance à Kashgar est à près de trois heures du midi solaire, ce qui représente une double-heure entière de la lecture.
Notes
Lorsque les transmissions diffèrent réellement, les deux lectures sont fournies et la réponse nomme la divergence plutôt que d'en choisir une silencieusement : la direction du tronc yin à travers les douze étapes, les deux placements de la lame yin, le noble 庚, l'élément de l'harmonie 午未, et les seuils de force, qui sont la convention de cette API et non une règle canonique. Nos quatre réponses conventionnelles sont déclarées dans la clause de non-responsabilité de chaque réponse et ont été testées par rapport à l'ensemble de sondes CC0 de l'Almanach de Jade ; les résultats sont sur la page des conventions.
Try the Thème BaZi API
Grab a key and make your first call in under a minute.