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

##宣布 AstroWay API —Backend حسابي للمطورين الذين يبنيون تطبيقات التنجيم، ومنتجات الأبراج، وميزات التوافق للتواعد، ووكالات الذكاء الاصطناعي التي تحتاج إلى التفكير في خرائط الميلاد.

في هذه المقالة، سنتحدث عن ماهية API، والحلول غير التقليدية التي اعتمدناها، وما قررنا تركه خارج النطاق، وكيف وصلنا إلى هنا. بدون كلام فارغ.

🕓 تدوينة بتاريخ 2026-04-22، آخر تحديث 2026-05-09. بعض الأرقام أصبحت قديمة. الوضع الحالي: 723 نقطة نهاية (وليس 87 عند الإطلاق)، 818 اختبار لقطات CI (وليس 183)، خادم MCP @astroway/mcp + حزمة تطوير البرامج (SDK) TypeScript @astroway/sdk + حزمة تطوير البرامج (SDK) Python astroway + حزمة تطوير البرامج (SDK) PHP astroway/sdk متاحة الآن في السجلات العامة. يمكنك الاطلاع على أحدث التحديثات في /faq وسجل التغييرات.

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

الأرقام:

• 723 نقطة نهاية — التنجيم الغربي (الولادة، السيناستريا، الترانزيت، التقدم، الاتجاهات، العودة، التوافقيات، النجوم الثابتة، النقاط العربية، علم التنجيم الجغرافي) بالإضافة إلى مجموعة كاملة من تصميم الإنسان (Human Design)
• 183 اختبار لقطات في CI مقابل الإخراج الفعلي لـ swetest CGI وكتالوج الكسوف التابع لوكالة ناسا — يتم تشغيلها مع كل طلب سحب (PR)
• p50 < 100 مللي ثانية، p95 < 500 مللي ثانية للنقاط النهائية الحسابية النموذجية
• خادم MCP @astroway/mcp + ثلاثة حزم تطوير برامج (SDK) في السجلات العامة: @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. ركزت على التنجيم الفيدي (Vedic)، مع تقديم التنجيم الغربي كخيار ثانوي

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

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

1. يجب أن يكون نفس المحرك الحسابي متاحًا للمطورين الآخرين — ليس لأنهم لن يتمكنوا من كتابته بأنفسهم، بل لأن مجموعة المكتبة + WASM + التخزين المؤقت + CI للاختبار الدقيق تستغرق نصف عام من العمل لا يستحق أي شخص تكراره.
2. تغطيتنا تصميم الإنسان (Human Design) (12 نقطة نهاية — الخريطة، النوع، السلطة، الملف الشخصي، البوابات، القنوات، الدوائر، التنشيطات الكوكبية، صليب التجسد، التعريف) حقًا فريدة من نوعها. لا يقدم أي منافس مجموعة كاملة من تصميم الإنسان (Human Design) عبر 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 api.astroway.info"
}

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

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

يتم توجيه نقاط نهاية /interpret/* من خلال بوابتنا الخاصة للذكاء الاصطناعي، والتي تعمل فوق أفضل نماذج السوق (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) مع فشل تلقائي. نحن لا نغلقك في مطالبنا — كل إجابة تحتوي على الحسابات الأصلية، لذا يمكنك استبدال نموذجك الخاص إذا لم يعجبك صوتنا. نحن نؤرخ المطالبات والإجابات الكاملة في جدول تدقيق للامتثال B2B (محفوظة لمدة 90 يومًا).

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

1. اقرأ الوثائق إذا كنت تريد فهم “السبب”: api.astroway.info/overview
2. بدء سريع في 5 دقائق مع الكود: البدء السريع لواجهة برمجة التطبيقات للتنجيم
3. الأسعار، بما في ذلك جدول الائتمانات لكل نقطة نهاية: api.astroway.info/pricing
4. سجل حسابك — مجانًا، بدون بطاقة: api.astroway.info/dashboard/sign-up

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

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

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

مرحبًا بكم.