AstroWay/api v2.173.1 · ar
جميع الأنظمة تعمل بشكل طبيعي
// astrology api · POST /v1/chinese/zodiac/compatibility

API لتوافق الأبراج الصينية

تحط تاريخين للولادة، وتطلع نتيجة متقيمة، مبني على هندسة الفروع الـ12 بدل ما يكون على جدول آراء. حيوان السنة يتحدد عند لحظة Li Chun بالضبط، فلو مولود في February يطلع له الحيوان اللي فعلاً ينتمي له.

Endpoint
POST /v1/chinese/zodiac/compatibility
Cost
10 credits
Latency
~60 ms
Tier
Tier 1
// 01 / What it computes

API لتوافق الأبراج الصينية

كل تاريخ يتحول لسنة شمسية، اللي بتبدأ عند لحظة Li Chun من الإفيريمس بدل ما تكون 1 January أو رأس السنة الصينية. السنة دي تعطي الفرع الأرضي وحيوانه. بعدين النتيجة تقرأ العلاقة بين الفرعين: ثلاثيات 三合، اللي بتجمع أربع مجموعات من ثلاث فروع موزعين بالتساوي حول الدائرة، وتصادمات 六冲، اللي بتقابل كل فرع مع اللي مقابل له مباشرة. العلاقات الجارة والمحايدة تكون بينهما. الرد يرجع الحيوانين المحددين، نتيجة رقمية، فئة وملاحظة قصيرة تشرح معنى التوافق، عشان UI تعرض الحكم بدون جدول بحث ثاني.

// 02 / Live request

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" }
  }'
Response (excerpt)
{
  "ok": true,
  "data": {
    "person1": { "solarYear": 1990, "animal": "Horse" },
    "person2": { "solarYear": 1988, "animal": "Dragon" },
    "compatibility": {
      "score": 65,
      "category": "good",
      "notes": ["Compatible enough; complementary differences."]
    }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

When to use it

استخدمه لما تحتاج إشارة توافق سريعة ورخيصة مبنية على تاريخ بس: فلتر مطابقة، بطاقة قابلة للمشاركة، اختبار، ودجت تسويقي، خطوة onboarding لو طلب وقت الميلاد يكلفك التحويل. هو أبسط قراءة في catalogue وصريح فيها، لأن حيوان السنة يعرف حرف واحد بس من ثمان شخصيات الشخص. لما المنتج يحتاج قراءة حقيقية، خذ مخطط BaZi كامل للاثنين وشوف التفاعلات عبر الأربعة أعمدة.

// 05 / Notes

Notes

النتيجة مستمدة من عقيدة 三合 و 六冲 الرسمية، مش من مصفوفة آراء مكتوبة يدويًا، عشان كده النتيجة قابلة لإعادة الإنتاج وتشرح نفسها. الولادة خلال يوم من Li Chun هي الحالة الوحيدة اللي الساعة تهم: مرّر time و timezoneOffset والحد بيتحدد للثانية. أسماء الحيوانات تُترجم لـ21 لغة؛ الـ English token يظل ثابت.

Try the توافق الأبراج الصينية API

Grab a key and make your first call in under a minute.

99.9% SLA · الخطط المدفوعة · 30d الحالة →