AstroWay/api v2.201.7 · ar
جميع الأنظمة تعمل بشكل طبيعي
// astrology api · POST /v1/fixed-stars

API للنجوم الثابتة

بعد الكواكب المتحركة، الطبقة الأقدم في علم الفلك تقرأ النجوم الثابتة - Regulus, Spica, Algol, Aldebaran وغيرهم. هالنقطة (endpoint) تفحص خريطة الميلاد للاتصالات القريبة مع هالنجوم الكبيرة وترجع كل اتصال مع مداره، عشان تقدر تضيف شخصية النجم المزعومة للقراءة.

Endpoint
POST /v1/fixed-stars
Cost
20 credits
Latency
~96 ms
Tier
Tier 2
// 01 / What it computes

API للنجوم الثابتة

من تاريخ الميلاد، الوقت، فرق UTC، والإحداثيات اللي تعطيها، هالنقطة (endpoint) تحسب نقاط الخريطة ثم تمشي في كتالوج النجوم الثابتة الكبيرة المستمد من تقليد Vivian Robson وPtolemy - النجوم الساطعة ذات الوزن الفلكي مو كل السماء. لكل نجم، تختبر نقاط الخريطة للاتحاد، وإذا وقع داخل المدار، تسجل الاتصال مع قيمة المدار بالضبط. الناتج تحت data.stars هو قائمة من الضربات بين النجم والنقطة: أي نجم، أي نقطة خريطة يلمسها، وقد إيش القرب، فالاتحاد بنصف درجة يقرأ أقوى من اللي على حافة المدار. بس الاتحادات تُحسب - التقنية تعتبر النجم مهم إذا نقطة الخريطة واقفة عليه، مو إذا كان يشكل زوايا طولية مع الكواكب. هالشي يطلع لك النجوم المسماة اللي المصادر الكلاسيكية حددتها كمباركة أو خطرة، جاهزة لتطابقها مع معنى نجمتك.

// 02 / Live request

POST/v1/fixed-stars

curl -X POST https://api.astroway.info/v1/fixed-stars \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "stars": [
      {
        "star": "Regulus",
        "point": "Mercury",
        "orb": 0.4
      },
      {
        "star": "Algol",
        "point": "Mars",
        "orb": 1.1
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
// 04 / When to use it

When to use it

استخدم هالنقطة (endpoint) لما قراءة الخريطة تحتاج تفاصيل إضافية للنجوم المسماة - مفسر تقليدي أو واعي بالنجوم الثابتة، مولد تقارير يبرز اتصال Algol أو Regulus الملكي، أو أداة تعليمية تشرح قصة أقوى النجوم. التصميم يركز على الاتحادات الضيقة فقط، فالناتج يطلع لك عدد قليل من الاتصالات المهمة بدل الضوضاء، وهذا يسهل عرضه كقائمة مختصرة مميزة. أعطيه نفس بيانات الميلاد اللي أرسلتها لنقطة natal-chart وراح تتطابق الضربات النجمية مع مواقع الكواكب والزوايا الموجودة في خريطتك، وتقدر تضيف نجم أو زاوية مع النجم المتواجد معه. لأن الكتالوج مختار للنجوم التقليدية المهمة، تقدر تربط نص تفسيري جاهز لكل واحد بدون ما ترتب القائمة بنفسك.

// 05 / Notes

Notes

كتالوج النجوم يتبع الاختيار اللي ورثه Vivian Robson وPtolemy - النجوم الثابتة الفلكية المهمة، مو مسح كامل للسماء. المواقع النجمية وخطوط الطول محسوبة بواسطة Swiss Ephemeris (Astrodienst) محرك في البروج الاستوائي، وبس الاتحادات داخل المدار تُرجع.

Try the النجوم الثابتة API

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

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