Zi Wei Dou Shu (النجم الأرجواني) API
تاريخ ميلاد، وقت وجنس ينتجون الخريطة كاملة: 12 قصر بأعمدةهم، كل الـ14 نجمة رئيسية، المساعدات، 31 نجمة صغرى، الـ12 مرحلة حياة، حدود العقد الأربعة وتحولات الأربعة المرسومة على النجوم اللي تحملها.
Zi Wei Dou Shu (النجم الأرجواني) API
الولادة تتحول لتاريخ قمري، لأن Zi Wei نظام قمري بحت، ومختلف عن BaZi ما يبدل إلى الفصول الشمسية. من الشهر القمري والساعة المزدوجة، النقطة النهاية تحط قصر الروح وقصر الجسد، بعدين تحط أعمدة كل قصر حسب قاعدة الخمسة نمور، بعدين تقرأ فئة الخمسة عناصر من عمود قصر الروح. هالفئة واليوم القمري يحطوا 紫微 حسب قاعدة الاستعارة والقسمة الكلاسيكية، والست نجوم من سلسلتها تتبع بإزاحات ثابتة، 天府 يعكسها عبر محور 寅-申 ويحمل ثمانيته الخاصة. فوق هالهيكل يضيفوا ست نجوم حظ جيدة وست نجوم ضارة، مخزن الراتب والحصان السماوي، 31 نجمة صغرى مربوطة بأعمدة السنة، فرع السنة، الشهر، اليوم والساعة، الـ12 مرحلة حياة، دورة العالم، دورة الجنرال ودورة السنة، حدود العشر سنوات اللي تفتح حسب رقم الفئة، والحد السنوي إذا طلبت العمر. التحولات الأربعة تُحل من عمود السنة وتُرفق بالنجوم نفسها بدل ما تُرجع كقائمة منفصلة.
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
}'{
"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 }
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| 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. |
When to use it
استخدمه لما تبني منتج فلك صيني لسوق يقرأ غير الصينية: تطبيق، خدمة قراءة، مُظهر خريطة، أو وكيل يحتاج البنية قبل ما يفسر. الرد هو بنية صافية بدون نص، فبسهولة يندمج مع شبكة 12 قصر، مولد تقارير أو طلب LLM. نقاط النهاية المرجعية في نفس العائلة أرخص ومفيدة للقواميس والـtooltips، لكنهم يرجعون نفس الجدول لكل ولادة ويذكرونها بحقل، فلا تبني خريطة منهم.
Notes
مربوط بثلاث خرائط منشورة بدل مكتبة وحدة، عن قصد: تقريباً كل نظام Zi Wei المفتوح المصدر يجي من مشروع واحد، فالموافقة على عدة منهم تعني الموافقة على واحد. خريطتين كاملتين ينعكسان بالضبط، والثالث يجي من نص تعليمي غير مرتبط. أربع مفاتيح مدرسة موجودة في جسم الطلب مو في الكود، لأن كل وحدة تحرك الخريطة كلها للولادات اللي تمسها: حد السنة، الشهر الكبيس، التحول عند 23:00 وجدول التحولات. إذا حاسبة ثانية تختلف، شيّك هالأربعة قبل الحساب.
Try the Zi Wei Dou Shu API
Grab a key and make your first call in under a minute.