API لتوافق الأبراج الصينية
تحط تاريخين للولادة، وتطلع نتيجة متقيمة، مبني على هندسة الفروع الـ12 بدل ما يكون على جدول آراء. حيوان السنة يتحدد عند لحظة Li Chun بالضبط، فلو مولود في February يطلع له الحيوان اللي فعلاً ينتمي له.
API لتوافق الأبراج الصينية
كل تاريخ يتحول لسنة شمسية، اللي بتبدأ عند لحظة Li Chun من الإفيريمس بدل ما تكون 1 January أو رأس السنة الصينية. السنة دي تعطي الفرع الأرضي وحيوانه. بعدين النتيجة تقرأ العلاقة بين الفرعين: ثلاثيات 三合، اللي بتجمع أربع مجموعات من ثلاث فروع موزعين بالتساوي حول الدائرة، وتصادمات 六冲، اللي بتقابل كل فرع مع اللي مقابل له مباشرة. العلاقات الجارة والمحايدة تكون بينهما. الرد يرجع الحيوانين المحددين، نتيجة رقمية، فئة وملاحظة قصيرة تشرح معنى التوافق، عشان UI تعرض الحكم بدون جدول بحث ثاني.
POST/v1/chinese/zodiac/compatibility
curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"person1": { "date": "1990-05-15" },
"person2": { "date": "1988-02-20" }
}' {
"ok": true,
"data": {
"person1": { "solarYear": 1990, "animal": "Horse" },
"person2": { "solarYear": 1988, "animal": "Dragon" },
"compatibility": {
"score": 65,
"category": "good",
"notes": ["Compatible enough; complementary differences."]
}
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| person1.date | string (YYYY-MM-DD) | yes | First birth date. The animal comes from the solar year, which opens at Li Chun, not at New Year. |
| person2.date | string (YYYY-MM-DD) | yes | Second birth date. |
| person1.time | string (HH:MM:SS) | no | Only matters for a birth within a day of Li Chun, where the hour decides the year. |
| person1.timezoneOffset | number (hours) | no | The UTC offset the clock was on. Used with time to place a boundary birth. |
| person1.solarYear | number | no | Override the resolved year outright when you already hold it. |
| language | string | no | Any of 21 codes. Adds animalName next to the English token; the English fields do not move. |
When to use it
استخدمه لما تحتاج إشارة توافق سريعة ورخيصة مبنية على تاريخ بس: فلتر مطابقة، بطاقة قابلة للمشاركة، اختبار، ودجت تسويقي، خطوة onboarding لو طلب وقت الميلاد يكلفك التحويل. هو أبسط قراءة في catalogue وصريح فيها، لأن حيوان السنة يعرف حرف واحد بس من ثمان شخصيات الشخص. لما المنتج يحتاج قراءة حقيقية، خذ مخطط BaZi كامل للاثنين وشوف التفاعلات عبر الأربعة أعمدة.
Notes
النتيجة مستمدة من عقيدة 三合 و 六冲 الرسمية، مش من مصفوفة آراء مكتوبة يدويًا، عشان كده النتيجة قابلة لإعادة الإنتاج وتشرح نفسها. الولادة خلال يوم من Li Chun هي الحالة الوحيدة اللي الساعة تهم: مرّر time و timezoneOffset والحد بيتحدد للثانية. أسماء الحيوانات تُترجم لـ21 لغة؛ الـ English token يظل ثابت.
Try the توافق الأبراج الصينية API
Grab a key and make your first call in under a minute.