API huyền học Trung Hoa

53 endpoint chia thành bốn nhóm: BaZi (18), lịch và con giáp Trung Hoa (15), Zi Wei Dou Shu (14) và I Ching (6). Lịch được suy ra từ ephemeris chứ không phải từ bảng ngày, nên hoạt động cho các năm từ 2 đến 2899 và không phụ thuộc vào việc có ai cập nhật bảng tra hay không.

Bao gồm những gì

Nhóm	Số endpoint	Trạng thái
BaZi: tứ trụ và phân tích	18	Đầy đủ bộ công cụ cổ điển
Lịch, con giáp, phong thủy, Thông Thư	15	Suy ra từ ephemeris
Zi Wei Dou Shu	14	An sao được tính toán, mười một bảng tra vẫn là bảng tra
I Ching	6	Quẻ, gieo đồng xu, hào động

Khác gì so với thư viện miễn phí

Câu trả lời thành thật: nếu chỉ cần tứ trụ, hãy dùng lunar-typescript. Nó theo giấy phép MIT, tính trong tiến trình của bạn, offline, không giới hạn tần suất, và không phải trả tiền.

Sự khác biệt bắt đầu ở chỗ thư viện kết thúc.

Tính năng	Thư viện MIT	AstroWay API
Tứ trụ, 藏干, 纳音, 十神	có	có
神煞 với cả hai cách đọc ở chỗ các trường phái bất đồng	không	có
Tương tác địa chi 刑冲合害	không	có
Sức mạnh nhật chủ trong khung 扶抑	không	có
Giờ mặt trời thực như một phép tính riêng	không	có
Phi tinh theo tọa và hướng, số Quái	không	có
Chọn ngày theo Thông Thư với bộ lọc theo hoạt động	không	có
Hai mươi mốt ngôn ngữ	không	có
Một quy ước chung cho PHP, JavaScript và Python cùng lúc	không	có

Dòng cuối cùng chính là thứ người ta thường trả tiền. Một đội có website bằng PHP, ứng dụng bằng JavaScript và cron bằng Python, nếu không thì phải duy trì ba cách triển khai ranh giới năm và sớm muộn sẽ nhận ba câu trả lời khác nhau cho cùng một ngày sinh.

Các quy ước được nêu rõ

Bốn trục mà các công cụ tính bất đồng, và không trục nào là lỗi. Phần lớn các cách triển khai chọn một cách lặng lẽ; chúng tôi ghi lựa chọn vào phản hồi và duy trì trang quy ước với một lượt chạy đối chiếu bộ dữ liệu CC0 bên ngoài.

Trục	Câu trả lời của chúng tôi
Ranh giới năm	立春 Lichun, thời điểm chính xác từ ephemeris
Ranh giới ngày	23:00, 子時 sớm thuộc về ngày hôm sau
Giờ mặt trời thực	tắt theo mặc định, bật bằng một cờ
Giờ mùa hè	được xác định bởi timezoneOffset do client gửi

Ví dụ

curl

curl -X POST https://api.astroway.info/v1/bazi/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

TypeScript

import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const r = await aw.client.POST('/bazi/chart', {
  body: { date: '1990-05-15', time: '14:30:00', timezoneOffset: 3 },
});
console.log(r.data?.data?.pillars.map((p) => p.pillar));
// [ 'Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei' ]

Python

import os
from astroway import Astroway

aw = Astroway(api_key=os.environ["ASTROWAY_API_KEY"])

chart = aw.post("/bazi/chart", body={
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
})
print([p["pillar"] for p in chart["pillars"]])
# ['Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei']

Phương thức có kiểu

Các route phân tích BaZi xuất hiện sau bản phát hành SDK hiện tại, nên chưa có phương thức có kiểu aw.bazi.chart(...). Các ví dụ trên dùng client thô, vốn đã hoạt động với mọi đường dẫn ngay hôm nay. Các wrapper có kiểu sẽ có trong bản phát hành SDK tiếp theo.

Ứng dụng hoàn chỉnh có thể clone

Demo trực tiếp và code trên GitHub, MIT.

Hai lời gọi, POST /v1/bazi/chart với giá 20 credit và POST /v1/bazi/luck-pillars với giá 10, trả về tứ trụ kèm tàng can, nạp âm và mười hai trạng thái, nhật chủ kèm kết luận về sức mạnh, cân bằng ngũ hành, thần sát, tương tác địa chi và chu kỳ mười năm Đại Vận. Ứng dụng vẽ chúng ra: năm ở bên phải, như trong cách ghi cổ điển, cột ngày được đánh dấu. Backend là một route duy nhất và không có phụ thuộc nào, vì đó chính là mấu chốt: trình duyệt không thể gọi thẳng API, nên key nằm trên máy chủ.

git clone https://github.com/astroway/starter-bazi
cd starter-bazi && npm install
cp .env.example .env     # your key goes here
npm run dev

Ba điều nên mang theo từ nó. Hãy gửi tên múi giờ, không gửi độ lệch: Asia/Shanghai vào ngày 1990-05-15 là UTC+9, vì Trung Quốc áp dụng giờ mùa hè từ 1986 đến 1991. Hãy gửi ngôn ngữ: mặc định là tiếng Ukraina, và một trang tiếng Anh không gửi ngôn ngữ sẽ nhận tên ngũ hành sai ngôn ngữ. Hãy gửi giới tính: Đại Vận đi thuận hoặc nghịch tùy theo nó, không có giá trị trung tính.

Ngôn ngữ

Con giáp, ngũ hành, âm và dương, các cung và mười hai trạng thái được dịch sang 21 ngôn ngữ. Thêm ?lang=es, và bên cạnh token tiếng Anh sẽ xuất hiện trường *Name. Các trường tiếng Anh không bao giờ thay đổi: bản địa hóa bổ sung chứ không thay thế.

Thiên can, địa chi, tên sao và 纳音 cố ý không được dịch: tên quốc tế của chúng là pinyin đặt cạnh chữ Hán.

Các mục tài liệu

Tổng quan Những gì được tính, những gì không có và vì sao.

BaZi: tứ trụ Mười tám endpoint và năm chỗ các trường phái bất đồng.

Con giáp và lịch Ba con giáp, ngày âm lịch, hai mươi bốn tiết khí.

Zi Wei Dou Shu An sao, mười hai cung và bốn công tắc trường phái.

Quy ước Bốn trục và lượt chạy đối chiếu bộ dữ liệu bên ngoài.

Câu hỏi thường gặp Không rõ giờ sinh, giờ mặt trời thực, tình trạng Zi Wei.

Phi tinh Chín cung, vận, tọa và hướng.