中国形而上学 API

4 つのファミリーにわたる 53 のエンドポイント: BaZi (18)、中国の暦と十二支 (15)、Zi Wei Dou Shu (14)、I Ching (6)。暦は日付の表ではなく天体暦から導いているため、西暦 2 年から 2899 年まで動作し、誰かが参照表を更新したかどうかに左右されません。

含まれるもの

ファミリー	エンドポイント数	状態
BaZi: 命式と分析	18	古典の体系を完備
暦、十二支、風水、通書	15	天体暦から導出
Zi Wei Dou Shu	14	星の配置は計算、11 のリファレンスはリファレンスのまま
I Ching	6	卦、コイン投げ、変爻

無料のライブラリとの違い

正直に言えば、四柱だけが必要なら lunar-typescript を使ってください。MIT ライセンスで、あなたのプロセス内でオフラインで計算し、呼び出し頻度の制限もなく、料金もかかりません。

違いは、ライブラリが終わるところから始まります。

項目	MIT ライセンスのライブラリ	AstroWay API
四柱、藏干、纳音、十神	あり	あり
流派が分かれる箇所で両方の読みを示す神煞	なし	あり
地支の相互作用刑冲合害	なし	あり
扶抑の枠組みでの日主の強弱	なし	あり
独立した計算としての真太陽時	なし	あり
座向による玄空飛星、卦数	なし	あり
行事でフィルタする通書の択日	なし	あり
21 言語	なし	あり
PHP、JavaScript、Python で同時に 1 つの規約	なし	あり

最後の行こそ、通常お金を払う理由です。サイトは PHP、アプリは JavaScript、cron は Python というチームは、そうでなければ年の境界の実装を 3 つ抱え、いずれ同じ生年月日に 3 つの異なる答えを得ることになります。

規約は明示しています

計算機によって答えが分かれる軸は 4 つあり、どれも誤りではありません。ほとんどの実装は黙って選びますが、こちらは選択をレスポンスに書き、外部の CC0 データセットで検証した規約のページを用意しています。

軸	こちらの答え
年の境界	立春 Lichun、天体暦による正確な瞬間
日の境界	23:00、早子時は翌日に属する
真太陽時	デフォルトで無効、フラグで有効化
夏時間	クライアントが送る `timezoneOffset` で解決

例

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}'

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' ]

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']

クローンできる既成のアプリ

ライブデモと GitHub のコード、MIT ライセンスです。

POST /v1/bazi/chart (20 クレジット) と POST /v1/bazi/luck-pillars (10 クレジット) の 2 つの呼び出しで、藏干、納音、十二運付きの四柱、強弱の判定付きの日主、五行のバランス、神煞、地支の相互作用、10 年周期の大運が返ります。アプリはそれを描画します。古典的な書き方どおり年柱が右側で、日柱の列に印が付きます。バックエンドは 1 つのルート だけで依存関係はありません。それこそが要点です。ブラウザは API を直接呼べないため、キーはサーバー上に置きます。

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

ここから持ち帰ってほしいことが 3 つあります。オフセットではなくゾーン名を送ってください。1990-05-15 の Asia/Shanghai は UTC+9 です。中国は 1986 年から 1991 年まで夏時間を採用していました。言語を送ってください。デフォルトはウクライナ語なので、指定しないと英語のページに別の言語の五行名が入ります。性別を送ってください。大運は性別によって順行か逆行かが決まり、中立の値はありません。