Swiss Ephemeris API

Swiss Ephemeris هو المعيار الفعلي للحسابات الفلكية في علم التنجيم: حيث يعتمد عليه Astrodienst (astro.com) و Solar Fire و Kerykeion ومعظم البرامج الجادة. يقرأ تقاويم DE431 من NASA JPL ويوفر دقة أقل من الثانية. يوفر AstroWay API وصولاً مباشرًا عبر HTTP إليه - بدون تجميع مكتبة C، بدون تحميل ملفات .se1، وبدون إدارة الذاكرة. طلب POST واحد، واستجابة JSON.

لماذا Swiss Ephemeris عبر API

استضافة Swiss Ephemeris ذاتيًا تعني: تجميع مكتبة C (أو بناء WASM)، استضافة مئات الميغابايت من ملفات .se1، إبقائها محدثة وتنفيذ رؤوس البيوت والجوانب والأطوار بنفسك. عبر API، كل هذا هو شأن شخص آخر:

• صفر بنية تحتية: لا توجد ملفات ثنائية، ولا ملفات تقاويم، ولا تأخيرات بدء تشغيل باردة. يتم إجراء الحساب على جانب الخادم بنفس المحرك الذي يستخدمه Astrodienst.
• دقة أقل من الثانية: < 0.1″ مقابل swetest CGI المرجعي من Astrodienst، تم التحقق منه على 873 اختبارات لقطات مجمدة مع كل نشر.
• نطاق تاريخي كامل: يغطي DE431 الفترة من 13201 قبل الميلاد – 17191 بعد الميلاد، لذا يتم حساب الخرائط التاريخية والمستقبلية البعيدة دون فقدان الدقة.
• ليس فقط المواقع: بالإضافة إلى التقاويم، تتوفر رؤوس البيوت (15 نظامًا)، والجوانب، والكسوف، والعبور، والتقدمات على الفور - وهي أشياء كان عليك كتابتها بنفسك عند الاستضافة الذاتية.

نصيحة

تم التحقق من دقة المحرك مقابل ثلاثة مصادر مستقلة (swetest CGI، Kerykeion، Prokerala) + مقابل كتالوج كسوف NASA 5-Millennium. التفاصيل والأرقام - على صفحة دقة الحسابات.

ما يتم حسابه باستخدام Swiss Ephemeris

نقطة النهاية	الاعتمادات	ما يعيده
/v1/chart	20	خريطة كاملة: الكواكب + البيوت + الجوانب
/v1/planets	10	مواقع الكواكب الجيو-مركزية (خط الطول، خط العرض، السرعة، التراجع)
/v1/houses	10	رؤوس البيوت - 15 نظامًا (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	العبور إلى الخريطة الفلكية بتاريخ محدد
/v1/progressions	50	التقدمات الثانوية (يوم = سنة)
/v1/eclipses	100	كسوف الشمس وخسوف القمر (تم التحقق منه مقابل كتالوج ناسا)
/v1/moon-phase	10	طور القمر، الإضاءة، الأرباع التالية
/v1/fixed-stars	20	اقترانات الكواكب بالنجوم الثابتة

هذا جزء من 760 نقطة نهاية للمنصة - القائمة الكاملة في مرجع API.

مثال

cURL

curl -X POST https://api.astroway.info/v1/planets \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/planets', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});
const { data } = await r.json();
const sun = data.planets.find((p) => p.name === 'Sun');
console.log(`Sun: ${sun.longitude.toFixed(4)}° retrograde: ${sun.isRetrograde}`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/planets',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
data = r.json()['data']
sun = next(p for p in data['planets'] if p['name'] == 'Sun')
print(f"Sun: {sun['longitude']:.4f}° retrograde: {sun['isRetrograde']}")

من يستخدمه

• مطورو تطبيقات التنجيم: مواقع دقيقة أقل من الثانية بدون استضافة مكتبة C ذاتيًا
• وكلاء الذكاء الاصطناعي: تقاويم دقيقة كأساس لـ LLM (عبر خادم MCP)
• الباحثون: حسابات جماعية على النطاق التاريخي لـ DE431
• الترحيل من الاستضافة الذاتية: استبدال swisseph المحلي بـ HTTP دون فقدان الدقة

التكلفة

مواقع الكواكب (/v1/planets) - 10 اعتمادات، الخريطة الكاملة (/v1/chart) - 20. على الخطة المجانية (760+ نقاط نهاية، 10,000 اعتماد/شهر) - حوالي 1000 طلب كوكب شهريًا مجانًا، بدون بطاقة.

دقة الحسابات → التحقق الثلاثي، التحقق من ناسا، اختبارات اللقطات

البدء السريع أول طلب في 5 دقائق

الخطط من المجاني إلى المؤسسي