API الميتافيزيقا الصينية

53 نقطة نهاية موزعة على أربع عائلات: BaZi (18)، والتقويم الصيني والأبراج الصينية (15)، و Zi Wei Dou Shu (14)، و I Ching (6). التقويم مستخرج من الإفيميريس لا من جداول التواريخ، لذلك يعمل للسنوات من 2 إلى 2899 ولا يعتمد على ما إذا كان أحدهم قد حدّث الجدول المرجعي.

ما الذي يتضمنه

العائلة	نقاط النهاية	الحالة
BaZi: الأعمدة والتحليل	18	الجهاز الكلاسيكي الكامل
التقويم، الأبراج، الفنغ شوي، Tong Shu	15	مستخرج من الإفيميريس
Zi Wei Dou Shu	14	توزيع النجوم محسوب، وأحد عشر مرجعًا تبقى مراجع
I Ching	6	السداسيات، رمي العملات، الخطوط المتغيرة

ما الفرق عن مكتبة مجانية

الإجابة الصادقة: إذا كنت تحتاج الأعمدة الأربعة فقط، فاستخدم lunar-typescript. رخصتها MIT، وتحسب داخل عمليتك، دون اتصال، بلا حدود للمعدل، ودون أن تدفع شيئًا.

يبدأ الفرق حيث تنتهي المكتبة.

ماذا	مكتبات MIT	AstroWay API
الأعمدة الأربعة، 藏干، 纳音، 十神	نعم	نعم
神煞 بالقراءتين حيث تختلف المدارس	لا	نعم
تفاعلات الفروع 刑冲合害	لا	نعم
قوة سيد اليوم في إطار 扶抑	لا	نعم
التوقيت الشمسي الحقيقي كحساب مستقل	لا	نعم
النجوم الطائرة حسب الجلوس والواجهة، رقم Gua	لا	نعم
اختيار المواعيد وفق Tong Shu مع تصفية حسب النشاط	لا	نعم
إحدى وعشرون لغة	لا	نعم
عُرف واحد لـ PHP و JavaScript و Python في آن واحد	لا	نعم

السطر الأخير هو ما يُدفع مقابله عادة. الفريق الذي يدير موقعًا بـ PHP وتطبيقًا بـ JavaScript ومهامًا مجدولة بـ Python يضطر بغير ذلك إلى صيانة ثلاث تطبيقات لحدّ السنة، وعاجلًا أو آجلًا يحصل على ثلاث إجابات مختلفة لتاريخ ولادة واحد.

الأعراف مُعلنة صراحة

أربعة محاور تختلف عليها الحاسبات، ولا شيء منها خطأ. معظم التطبيقات تختار بصمت؛ نحن نكتب اختيارنا في الاستجابة ونحتفظ بـ صفحة الأعراف مع تشغيل على مجموعة بيانات خارجية بترخيص CC0.

المحور	إجابتنا
حدّ السنة	立春 Lichun، اللحظة الدقيقة من الإفيميريس
حدّ اليوم	23:00، و 子時 المبكرة تتبع اليوم التالي
التوقيت الشمسي الحقيقي	معطّل افتراضيًا، ويُفعّل بعلَم
التوقيت الصيفي	يُحسم عبر 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']

التوابع ذات الأنواع

ظهرت مسارات BaZi التحليلية بعد الإصدار الحالي للـ SDK، لذا لا توجد بعد توابع ذات أنواع مثل aw.bazi.chart(...). تستخدم الأمثلة أعلاه العميل الخام الذي يعمل مع أي مسار منذ اليوم. ستصل الأغلفة ذات الأنواع مع إصدار الـ SDK القادم.

تطبيق جاهز يمكنك استنساخه

عرض حي و الشيفرة على GitHub، برخصة MIT.

استدعاءان، POST /v1/bazi/chart بـ 20 رصيدًا و POST /v1/bazi/luck-pillars بـ 10، يُرجعان الأعمدة الأربعة مع السيقان الخفية و Na Yin والمراحل الاثنتي عشرة، وسيد اليوم مع حكم على قوته، وتوازن العناصر، والنجوم الرمزية، وتفاعلات الفروع، ودورة Da Yun العشرية. يرسمها التطبيق: السنة على اليمين كما في الكتابة الكلاسيكية، وعمود اليوم مميّز. الواجهة الخلفية مسار واحد بلا أي تبعيات، وهذا هو جوهرها: لا يستطيع المتصفح استدعاء الـ 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

ثلاثة أشياء تستحق أن تأخذها منه. أرسل اسم المنطقة الزمنية لا الإزاحة: Asia/Shanghai في 1990-05-15 هي UTC+9، لأن الصين طبّقت التوقيت الصيفي من 1986 إلى 1991. أرسل اللغة: الافتراضية هي الأوكرانية، والصفحة الإنجليزية دونها ستحصل على أسماء العناصر بلغة خاطئة. أرسل الجنس: تسير Da Yun إلى الأمام أو إلى الخلف تبعًا له، ولا توجد قيمة محايدة.

اللغات

الحيوانات، والعناصر، والين واليانغ، والقصور، والمراحل الاثنتا عشرة مترجمة إلى 21 لغة. أضف ?lang=es وسيظهر حقل *Name بجانب الرمز الإنجليزي. الحقول الإنجليزية لا تتغير أبدًا: التوطين يضيف ولا يستبدل.

السيقان، والفروع، وأسماء النجوم، و 纳音 لا تُترجم عمدًا: اسمها الدولي هو الـ pinyin بجانب الرمز الصيني.

أقسام التوثيق

نظرة عامة ما الذي يُحسب، وما غير الموجود، ولماذا.

BaZi: الأعمدة الأربعة ثماني عشرة نقطة نهاية وخمسة مواضع تختلف فيها المدارس.

الأبراج والتقويم ثلاثة حيوانات، التاريخ القمري، أربعة وعشرون فصلًا شمسيًا.

Zi Wei Dou Shu توزيع النجوم، القصور الاثنا عشر، وأربعة مفاتيح للمدرسة.

الأعراف أربعة محاور وتشغيل على مجموعة بيانات خارجية.

الأسئلة الشائعة وقت ولادة مجهول، التوقيت الشمسي الحقيقي، حالة Zi Wei.

النجوم الطائرة تسعة قصور، الحقبة، الجلوس والواجهة.