Kínai metafizikai API

53 endpoint négy családban: BaZi (18), kínai naptár és zodiákus (15), Zi Wei Dou Shu (14) és I Ching (6). A naptár efemeriszből van levezetve, nem dátumtáblákból, ezért a 2. és 2899. év között működik, és nem függ attól, hogy valaki frissítette-e a referenciát.

Mit tartalmaz

Család	Endpoint	Állapot
BaZi: oszlopok és elemzés	18	Teljes klasszikus eszköztár
Naptár, zodiákus, feng shui, Tong Shu	15	Efemeriszből levezetve
Zi Wei Dou Shu	14	A csillagok elhelyezését számoljuk, tizenegy referencia referencia marad
I Ching	6	Hexagramok, pénzfeldobás, változó vonalak

Miben különbözik egy ingyenes könyvtártól

Az őszinte válasz: ha csak a négy oszlopra van szükséged, használd a lunar-typescript könyvtárat. MIT-licences, a saját folyamatodban számol, offline, gyakorisági korlát nélkül, és fizetni sem kell érte.

A különbség ott kezdődik, ahol a könyvtár véget ér.

Mi	MIT-licences könyvtárak	AstroWay API
Négy oszlop, 藏干, 纳音, 十神	igen	igen
神煞 mindkét olvasattal, ahol az iskolák eltérnek	nem	igen
Az ágak kölcsönhatásai 刑冲合害	nem	igen
A napi uralkodó ereje a 扶抑 keretben	nem	igen
Valódi napidő külön számításként	nem	igen
Repülő csillagok ülés és homlokzat szerint, Gua-szám	nem	igen
Tong Shu dátumválasztás tevékenység szerinti szűréssel	nem	igen
Huszonegy nyelv	nem	igen
Egyetlen konvenció egyszerre PHP-hez, JavaScripthez és Pythonhoz	nem	igen

Általában az utolsó sorért fizetnek. Egy csapat, amelynek PHP-s a weboldala, JavaScriptes az alkalmazása és Pythonos a cronjai, különben három implementációt tart fenn az évhatárra, és előbb-utóbb három különböző választ kap ugyanarra a születési dátumra.

A konvenciók nyíltan megnevezve

Négy tengely, amely mentén a kalkulátorok eltérnek, és egyik sem hiba. A legtöbb implementáció csendben választ; mi beleírjuk a választást a válaszba, és fenntartunk egy konvenciós oldalt, egy külső CC0-adatkészleten lefuttatott ellenőrzéssel.

Tengely	A mi válaszunk
Évhatár	立春 Lichun, a pontos pillanat az efemeriszből
Naphatár	23:00, a korai 子時 a következő naphoz tartozik
Valódi napidő	alapértelmezésként kikapcsolva, jelzővel bekapcsolható
Nyári időszámítás	a kliens által küldött timezoneOffset dönti el

Példa

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

Típusos metódusok

A BaZi elemző útvonalai a jelenlegi SDK-kiadás után jelentek meg, ezért aw.bazi.chart(...) típusos metódusok még nincsenek. A fenti példák a nyers klienst használják, amely már ma is bármely útvonallal működik. A típusos burkolók a következő SDK-kiadással érkeznek.

Klónozható kész alkalmazás

Élő demó és kód a GitHubon, MIT.

Két hívás, a POST /v1/bazi/chart 20 kreditért és a POST /v1/bazi/luck-pillars 10-ért, visszaadja a négy oszlopot a rejtett törzsekkel, a nayinnal és a tizenkét szakasszal, a napi uralkodót az erejére vonatkozó ítélettel, az elemek egyensúlyát, a szimbolikus csillagokat, az ágak kölcsönhatásait és a tízéves Da Yun ciklust. Az alkalmazás ezeket rajzolja ki: az év jobbra, mint a klasszikus lejegyzésben, a nap oszlopa kiemelve. A backend egyetlen útvonal, függőségek nélkül, mert épp ez a lényeg: a böngésző nem fordulhat közvetlenül az API-hoz, így a kulcs a szerveren él.

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

Három dolog, amit érdemes átvenni belőle. Zónanevet küldj, ne eltolást: az Asia/Shanghai 1990-05-15-én UTC+9, mert Kína 1986 és 1991 között nyári időszámítást tartott. Küldd a nyelvet: az alapértelmezett az ukrán, és egy angol oldal enélkül nem a megfelelő nyelven kapja meg az elemek nevét. Küldd a nemet: a Da Yun ettől függően halad előre vagy hátra, semleges érték nem létezik.

Nyelvek

Az állatok, az elemek, a jin és a jang, a paloták és a tizenkét szakasz 21 nyelvre van lefordítva. Add hozzá a ?lang=es paramétert, és az angol token mellett megjelenik egy *Name mező. Az angol mezők soha nem változnak: a lokalizáció hozzáad, nem lecserél.

Az égi törzseket, a földi ágakat, a csillagok nevét és a 纳音-t szándékosan nem fordítjuk: nemzetközi nevük a pinjin az írásjegy mellett.

A dokumentáció fejezetei

Áttekintés Mit számolunk, mi hiányzik, és miért.

BaZi: négy oszlop Tizennyolc endpoint és öt pont, ahol az iskolák eltérnek.

Zodiákus és naptár Három állat, holdnaptári dátum, huszonnégy időszak.

Zi Wei Dou Shu A csillagok elhelyezése, tizenkét palota és négy iskolaváltó.

Konvenciók Négy tengely és ellenőrzés egy külső adatkészleten.

Gyakori kérdések Ismeretlen születési idő, valódi napidő, a Zi Wei állapota.

Repülő csillagok Kilenc palota, periódus, ülés és homlokzat.