चीनी तत्वमीमांसा API

चार परिवारों में 53 एंडपॉइंट: BaZi (18), चीनी कैलेंडर और राशिचक्र (15), Zi Wei Dou Shu (14) और I Ching (6)। कैलेंडर ephemeris से निकाला गया है, तारीख़ों की तालिकाओं से नहीं, इसलिए यह वर्ष 2 से 2899 तक काम करता है और इस पर निर्भर नहीं कि किसी ने reference तालिका अपडेट की या नहीं।

इसमें क्या शामिल है

परिवार	एंडपॉइंट	स्थिति
BaZi: स्तंभ और विश्लेषण	18	पूरा शास्त्रीय तंत्र
कैलेंडर, राशिचक्र, फ़ेंग शुई, Tong Shu	15	ephemeris से निकाला गया
Zi Wei Dou Shu	14	तारों की स्थापना कैलकुलेट होती है, ग्यारह reference सूचियाँ reference ही रहती हैं
I Ching	6	हेक्साग्राम, सिक्के उछालना, बदलती रेखाएँ

यह मुफ़्त library से कैसे अलग है

ईमानदार जवाब: अगर सिर्फ़ चार स्तंभ चाहिए, तो lunar-typescript लीजिए। यह MIT के तहत है, आपके process में, offline, बिना rate limit के कैलकुलेट करता है, और इसके लिए कुछ चुकाना नहीं पड़ता।

फ़र्क वहाँ शुरू होता है जहाँ library ख़त्म होती है।

क्या	MIT libraries	AstroWay API
चार स्तंभ, 藏干, 纳音, 十神	हाँ	हाँ
神煞, जहाँ परंपराएँ अलग हैं वहाँ दोनों पाठ	नहीं	हाँ
शाखाओं की पारस्परिक क्रियाएँ 刑冲合害	नहीं	हाँ
扶抑 ढाँचे में Day Master का बल	नहीं	हाँ
वास्तविक सौर समय अलग गणना के रूप में	नहीं	हाँ
बैठक और मुखौटे के अनुसार Flying Stars, Gua संख्या	नहीं	हाँ
गतिविधि फ़िल्टर के साथ Tong Shu तारीख़ चुनाव	नहीं	हाँ
इक्कीस भाषाएँ	नहीं	हाँ
PHP, JavaScript और Python के लिए एक साथ एक ही convention	नहीं	हाँ

आख़िरी पंक्ति ही वह चीज़ है जिसके लिए आम तौर पर पैसे दिए जाते हैं। जिस टीम की साइट PHP में, ऐप JavaScript में और crons Python में हैं, वह वरना वर्ष की सीमा के तीन implementations रखती है और देर-सबेर एक ही जन्म तिथि पर तीन अलग जवाब पाती है।

Conventions खुलकर बताए गए

चार अक्ष, जिन पर कैलकुलेटर अलग-अलग नतीजे देते हैं, और इनमें से कोई भी ग़लती नहीं है। ज़्यादातर implementations चुपचाप चुनाव करते हैं; हम चुनाव जवाब में लिखते हैं और एक बाहरी CC0 dataset पर जाँच के साथ conventions पेज रखते हैं।

अक्ष	हमारा जवाब
वर्ष की सीमा	立春 Lichun, ephemeris से सटीक क्षण
दिन की सीमा	23:00, शुरुआती 子時 अगले दिन का है
वास्तविक सौर समय	default रूप से बंद, flag से चालू होता है
डेलाइट सेविंग टाइम	क्लाइंट के भेजे timezoneOffset से तय होता है

उदाहरण

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

Typed methods

BaZi के analytical routes SDK की मौजूदा release के बाद आए, इसलिए typed methods aw.bazi.chart(...) अभी नहीं हैं। ऊपर के उदाहरण raw client इस्तेमाल करते हैं, जो आज ही किसी भी path के साथ काम करता है। Typed wrappers SDK की अगली release के साथ आएँगे।

तैयार ऐप जिसे clone किया जा सकता है

लाइव डेमो और GitHub पर कोड, MIT।

दो कॉल, 20 क्रेडिट का POST /v1/bazi/chart और 10 का POST /v1/bazi/luck-pillars, छिपे stems, Na Yin और बारह अवस्थाओं के साथ चार स्तंभ, बल के निर्णय के साथ Day Master, तत्वों का संतुलन, प्रतीकात्मक तारे, शाखाओं की क्रियाएँ और दस वर्षीय Da Yun चक्र लौटाते हैं। ऐप इन्हें draw करता है: वर्ष दाईं ओर, जैसे शास्त्रीय लेखन में, और दिन का कॉलम चिह्नित। बैकएंड एक route है और कोई dependency नहीं, क्योंकि पूरी बात इसी में है: browser सीधे API को कॉल नहीं कर सकता, इसलिए key सर्वर पर रहती है।

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

इससे तीन बातें सीखने लायक हैं। zone का नाम भेजें, offset नहीं: 1990-05-15 को Asia/Shanghai UTC+9 है, क्योंकि चीन में 1986 से 1991 तक डेलाइट सेविंग टाइम था। भाषा भेजें: default यूक्रेनी है, और इसके बिना अंग्रेज़ी पेज को तत्वों के नाम ग़लत भाषा में मिलेंगे। लिंग भेजें: Da Yun इसके आधार पर आगे या पीछे चलता है, कोई तटस्थ मान नहीं है।

भाषाएँ

पशु, तत्व, यिन और यांग, महल और बारह अवस्थाएँ 21 भाषाओं में अनूदित हैं। ?lang=es जोड़ें, और अंग्रेज़ी token के बगल में *Name फ़ील्ड आ जाएगा। अंग्रेज़ी फ़ील्ड कभी नहीं बदलते: localization जोड़ता है, बदलता नहीं।

Stems, branches, तारों के नाम और 纳音 जान-बूझकर अनूदित नहीं होते: इनका अंतरराष्ट्रीय नाम चीनी अक्षर के बगल में pinyin है।

दस्तावेज़ के खंड

परिचय क्या कैलकुलेट होता है, क्या नहीं और क्यों।

BaZi: चार स्तंभ अठारह एंडपॉइंट और पाँच जगहें जहाँ परंपराएँ अलग होती हैं।

राशिचक्र और कैलेंडर तीन पशु, चांद्र तिथि, चौबीस सौर अवधियाँ।

Zi Wei Dou Shu तारों की स्थापना, बारह महल और परंपरा के चार switches।

Conventions चार अक्ष और बाहरी dataset पर जाँच।

अक्सर पूछे जाने वाले सवाल अज्ञात जन्म समय, वास्तविक सौर समय, Zi Wei की स्थिति।

Flying Stars नौ महल, अवधि, बैठक और मुखौटा।