إطلاق API AstroWay: حزمة كاملة من حسابات الفلك مع دقة Swiss Ephemeris

اليوم نعلن عن AstroWay API - خلفية حسابية للمطورين الذين يخلقون تطبيقات فلكية، منتجات أبراج، وظائف توافق للتعارف ووكلاء AI الذين يجب أن يتأملوا في خرائط الميلاد.

في هذه المقالة - ما هو فعلاً داخل الـ API، ما هي الحلول غير التقليدية التي اعتمدناها، ما الذي تركناه عن قصد، وكيف وصلنا إلى هنا. بدون مبالغة.

🕓 السجل من 2026-04-22، تم التحديث في 2026-05-09. بعض الأرقام قديمة. الحالة الحالية: 758 إندبوينت (وليس 87 عند الإطلاق)، 873 اختبار snapshot في CI (وليس 183)، MCP-сервер @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk الآن جميعها تعيش على السجلات العامة. الحالة المحدثة - في /faq و changelog.

REST API مبني على Swiss Ephemeris (LGPL)، مُجمّع إلى WASM ومُطلق كخدمة Node.js - الآن أيضاً مع تفسيرات AI (سلسلة failover من GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) فوق الحسابات الفعلية. نفس المحرك الذي يستخدمه علماء الفلك المحترفون منذ أكثر من 30 عاماً في Solar Fire، Kepler، Astro Gold و Janus - دقة تصل إلى جزء من الثانية الزاوية، تم التحقق منها مع إيفيميريد NASA JPL والمرجع الرسمي swetest من Astrodienst (Astro.com).

الأرقام:

• 758 إندبوينت: علم الفلك الغربي الولادي، السيناستري، العبور، التقدمات، التوجيهات، العوائد، الانسجامات، النجوم الثابتة، النقاط العربية، رسم الخرائط الفلكية بالإضافة إلى مجموعة كاملة من Human Design
• 183 اختبار snapshot في CI مقارنة بالإخراج الفعلي swetest CGI ودليل الظلال من NASA - يتم تشغيلها على كل طلب دمج (PR).
• p50 < 100 ملث، p95 < 500 ملث للـ إندبوينتات الحسابية النموذجية.
• MCP-сервер @astroway/mcp + ثلاثة SDKs على السجلات العامة: @astroway/sdk (npm)، astroway (PyPI)، astroway/sdk (Packagist) - نفس الـ API بثلاث لغات.
• MCP-сервер: @astroway/mcp - يقدم الـ API كأدوات لـ Claude، GPT، Cursor وغيرها من وكلاء LLM.
• خطط مبنية على الائتمان: خطة مجانية (10 000 ائتمان / شهر، بدون بطاقة)، مدفوعة - ابتداءً من $5 / شهر.

الدليل الكامل: api.astroway.info/docs/api/. الحالة الحية: api.astroway.info/status.

منذ ثلاث سنوات بدأنا نبني تطبيقات فلكية موجهة للمستهلكين. طبقة الحسابات كانت أصعب جزء - أكثر تعقيداً بكثير من الواجهة أو المحتوى. الخدمات الحالية إما:

1. لديها تغطية سطحية (10–30 إندبوينت، غالباً فقط الولادي).
2. كانت مكلفة على نطاق واسع ($0.02–$0.10 لكل طلب بدون خصومات الجملة).
3. استخدمت محركات مغلقة، لا يمكن التحقق من دقتها.
4. ركزت على الفلك الهندي، بينما قدمت الفلك الغربي كفرعي.

لذلك قمنا ببيع Swiss Ephemeris بأنفسنا وكتبنا طبقة حسابية خاصة - في البداية لمنتج المستهلك app.astroway.info، ثم لموقع التسويق astroway.info، الذي يقدم أبراج يومية لمئات الآلاف من الزوار شهرياً.

بعد ثلاث سنوات من تشغيل هذا الكود في الإنتاج وصلنا إلى استنتاجين:

1. يجب أن يكون محرك الحسابات نفسه متاحاً للمطورين الآخرين: ليس لأنهم لا يستطيعون كتابته بأنفسهم، بل لأن الستاك المكتبة + WASM + التخزين المؤقت + CI للدقة يمثل نصف عام من العمل لا ينبغي لأحد أن يكرره.
2. تغطيتنا Human Design (12 إندبوينت: الخريطة، النوع، السلطة، الملف، البوابة، القنوات، المخططات، التنشيطات الكوكبية، incarnation cross، التعريف) - فريدة حقاً. لا أي منافس يقدم مجموعة HD كاملة عبر الـ API.

هذا هو الإطلاق.

لدينا /nakshatras، /ashtakavarga وإندبوينتات للخرائط القسيمية، لكن لا توجد Dasha، Panchang، Ashtakoota، KP. السبب: في الفلك الهندي توجد خلافات غير محلولة بين المدارس (حروب أيانامشا، جدالات حول كوسبيدات KP، اختيار مدرسة الداش). تم إهمال الجزء الهندي ضد Prokerala و VedicAstroAPI لأنه سيتلقى نقداً.

الحل مثبت: حزمة الهندية - مرحلة منفصلة 3، بعد أن يكون هناك طلب ثابت على الغربي وسيكون هناك وقت للتحقق من صحتها مقابل Jagannatha Hora و Parashara’s Light. من الأفضل عدم الإطلاق مطلقاً من أن تطلق بشكل سيء.

استدعاء واحد لـ /chart يكلف تقريباً 50 مرة أقل من حسابات /forecast-calendar لمدة 365 يوماً. السعر الثابت لكل طلب إما سيحرم المستخدمين الخفيفين أو سيعوض المستخدمين الثقيلين. الائتمانات تربط التكلفة بالعمل الفعلي - انظر الجدول حسب الإندبوينتات في صفحة الأسعار.

الردود في الخطة المجانية تحتوي على حقل _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

هذا لا يكلفنا شيئاً، لكنه يمنح المستخدمين المجانيين حافزاً صغيراً للتحديث. في خطة Hobby+ يتم إزالته في إعدادات المفتاح. استعرنا النمط من Zapier و RevenueCat.

/rectification (اختيار وقت الميلاد بناءً على أحداث الحياة عبر بحث likelihood-grid) - مكلف حسابياً: استدعاء واحد يستغرق 10–60 ثانية ويجري عشرات الآلاف من الحسابات الوسيطة باستخدام Swiss Ephemeris. حدّناه بخطة Pro ($59 / شهر) وضعنا سعر ائتماني مرتفع، لأن الإساءة سيؤثر على البنية التحتية المشتركة للجميع.

إندبوينتات /interpret/* تُوجّه عبر بوابة AI الخاصة بنا، التي تعمل فوق نماذج السوق الأفضل (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) مع فشل تلقائي. نحن لا نحبسك في البرمجات الخاصة بنا - كل استجابة مع التفسير تتضمن الحسابات الأصلية، لذا يمكنك إعادة برمجة LLM الخاصة بك إذا لم يناسبك صوتنا. نحن نسجل البرمجات الكاملة والمخرجات في جدول audit للامتثال B2B (احتفاظ لمدة 90 يوماً).

• الحزمة الهندية: مرحلة 3، بعد أولى تأكيدات الطلب (انظر أعلاه).
• Webhook‑ات عند تحقيق العتبات: تم تنفيذها، لكن الواجهة لا تزال بدائية؛ نعمل على تحسينها.
• الودجات العامة (<script src="api.astroway.info/widget/natal.js">) - مرحلة 7.
• ملحق للموقع التسويقي الرئيسي: مشروع منفصل، مخطط ضمن نظام astroway.info.

1. اقرأ الوثائق إذا أردت أن تفهم «السبب»: api.astroway.info/overview
2. بدء سريع خلال 5 دقائق مع الكود: Astrology API Quick Start
3. الخطط, بما في ذلك جدول الائتمانات لكل إندبوينت: api.astroway.info/pricing
4. سجّل: مجاناً، بدون بطاقة: api.astroway.info/dashboard/sign-up

إذا بنيت شيئاً على الـ API - أو وجدت خطأ، أو تريد إندبوينت غير موجود لدينا - اكتب لنا. نفضل أن نسمع من مئة مطور يطلبون شيئاً، على أن نطلق ميزات لا يستخدمها أحد.

الأسئلة، الطلبات، الحالات الغريبة: hello@astroway.info.

خارطة الطريق عامة - PRODUCT-PLAN.md - ما تم إنجازه، ما هو التالي، ما تم تأجيله ولماذا.

أهلاً وسهلاً.