API Zi Wei Dou Shu (Sao Tím)
Ngày sinh, giờ sinh và giới tính tạo ra toàn bộ lá biểu: mười hai cung với cành của chúng, tất cả mười bốn sao chính, các sao phụ, ba mươi mốt sao phụ nhỏ, mười hai giai đoạn đời, giới hạn thập kỷ và bốn biến đổi được đánh dấu trên các sao mang chúng.
API Zi Wei Dou Shu (Sao Tím)
Ngày sinh được chuyển thành ngày âm lịch, vì Zi Wei là hệ thống thuần âm và không giống BaZi, không chuyển sang tiết khí. Từ tháng âm và giờ đôi, endpoint đặt cung linh hồn và cung thể xác, sau đó áp dụng quy tắc năm hổ để gắn cành cho mỗi cung, rồi đọc lớp ngũ hành từ cột cung linh hồn. Lớp đó và ngày âm lịch đặt 紫微 theo quy tắc vay-chia cổ điển, sáu sao trong chuỗi của nó theo các offset cố định, 天府 phản chiếu nó qua trục 寅-申 và mang thêm tám sao của mình. Trên khung sườn này còn có sáu sao may mắn và sáu sao xấu, kho lương và ngựa thiên, ba mươi mốt sao phụ nhỏ được gắn vào cành năm, cành năm, tháng, ngày và giờ, mười hai giai đoạn đời, chu kỳ học giả, chu kỳ chung và chu kỳ năm, giới hạn mười năm mở ở số lớp, và giới hạn hàng năm nếu hỏi tuổi. Bốn biến đổi được giải quyết từ cành năm và gắn vào các sao chứ không trả về danh sách tách rời.
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
Khi nào dùng? Dùng nó khi mày đang xây dựng sản phẩm tử vi Trung Quốc cho thị trường không đọc tiếng Trung: app, dịch vụ đọc, bộ vẽ biểu đồ, hay agent cần cấu trúc trước khi giải thích. Kết quả chỉ là cấu trúc thuần túy, không có văn bản, nên có thể nhúng vào lưới mười hai cung, trình tạo báo cáo hoặc prompt LLM. Các endpoint tham chiếu cùng nhóm rẻ hơn và hữu ích cho từ điển và tooltip, nhưng chúng trả cùng một bảng cho mọi ngày sinh và ghi trong một trường, vì vậy đừng dùng chúng để tạo biểu đồ.
Notes
Gắn vào ba biểu đồ đã công bố thay vì một thư viện, cố ý: hầu hết hệ sinh thái mã nguồn mở Zi Wei xuất phát từ một dự án duy nhất, vì vậy đồng ý với vài cái là đồng ý với một. Hai biểu đồ đầy đủ sao chép chính xác, và một biểu đồ thứ ba đến từ tài liệu giảng dạy không liên quan. Bốn công tắc trường học nằm trong body yêu cầu chứ không trong code, vì mỗi cái di chuyển toàn bộ biểu đồ cho các ngày sinh mà nó ảnh hưởng: ranh giới năm, tháng nhuận, chuyển 23:00 và bảng biến đổi. Khi máy tính khác không đồng ý, kiểm tra bốn cái này trước khi tính toán.
Try the Zi Wei Dou Shu API
Grab a key and make your first call in under a minute.