AstroWay/api v2.190.0 · ar
جميع الأنظمة تعمل بشكل طبيعي

خريطة الكتالوج: كيف تم تنظيم أكثر من 700 endpoint AstroWay

API نما إلى أكثر من 700 endpoint في 57 مجموعة - من الخريطة الولادية إلى BaZi، الجيومانتي، وتوليد خرائط SVG. نوضح كيف تم تقسيم الكتالوج إلى نطاقات، حيث يتبع جميع الاستدعاءات نمطًا موحدًا وكيفية العثور بسرعة على endpoint المطلوب.

مخطوطة AstroWay - هي 758 النقطات في 57 مجموعة. في هذا الحجم، السؤال الأساسي للمتكاملة ليس “هل هناك تغطية”، ولكن “كيف لا أضل”؟ هذه المقالة - خريطة: كيف يُقسم المخطوطة إلى المجالات والكيفية العثور على النقطة المطلوبة في دقيقة.

نمط واحد على جميع التطبيقات

Section titled “نمط واحد على جميع التطبيقات”

بما أن كل نقطة حسابية تتبع نفس الشكل:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

الجسم - JSON مع البيانات المولودة (التاريخ والوقت والتنسيق) أو المعطوفة الخاصة بالتقنية. الإجابة - دائمًا { "ok": true, "data": {...} } أو { "ok": false, "error": {...} }. لا توجد GraphQL ولا أي تطبيقات الحصول على إذن على المجال: واحد في رأس X-Api-Key واحد في نمط الإجابة.

هذا يعني أن التطبيق الذي تقوم بكتابةها تحت خريطة مناسبة أيضًا ل BaZi و ل الرُّن - التطبيق نفسه يختلف فقط في الطريق والنمط الجسم.

المخطوطة تُجمّع في مجالات كبيرة. هنا خريطة الحقيقية مع الأرقام (تتأخذ الأرقام من المانيفست على كل بناء، لذلك هنا دائمًا актуالية):

المجالالنقطاتما داخلها
الأستروولوجيا الغربية182خريطة المولودة، الأشكال، القوائم، التوقعات (الانتقال، التطور، التوجيه)، التوقعات الحالية، 4 المدارس الإللينية، التوقعات النفسية، التطورية، علم الكواكب
الأستروولوجيا الهندية174أكبر المجال: النقاط، الداشات، التقسيمات-الخريطة (الوارجا)، القوائم، الخصائص، جايميني، كيه بي، الأشتابالا
Human Design12البوديغراف، القنوات، الأبواب، النوع/النوع/السلطة، الصليب الحقيقي
تارو66ثلاثة الكؤلاد: رايدر-وايت-سميث، ماسيلون، لينورماند - التوقعات، المعاني، التكاملات
الأعداد505 أنظمة على 10 التطبيقات (البيثاغوري، الحلدي، الكاباليستي، الوجدية)
الأستروولوجيا الصينية + مايا55BaZi (الأربعة الأعمدة)، زي واي دو شو، الأستروولوجيا الصينية والفين شوي، التقويم مايا
التوقعات31الأستروولوجيا الجغرافية (أغريبا)، الأعمدة الرُّن القديمة، الأستروولوجيا اليدوية (شيرو)، الأي تشينغ
النيشات التطبيقية51الصحة، الأستروولوجيا الحيوانية، الأعمال، المال، الأسرة
التقارير23التوقعات المكتوبة (المولودة، السيناستري)، في HTML/PDF، مع العلامة البيضاء
رندر14SVG/PNG الدوائر الخريطة، البوديغراف، الدوائر المولودة - بدون فروع
أدوات التطوير44الأستروولوجيا الحية، التطوير في الوقت الحقيقي، الأعمدة المدمجة، العلامة البيضاء

النقاط الأخرى - التوقعات الآلية، الأستروولوجيا، النقاط المولودة (الزodiac، النجوم، الأشكال) و النقاط النظامية (الصحة، الاستخدام، OpenAPI).

الأستروولوجيا الهندية - قصة خاصة

Section titled “الأستروولوجيا الهندية - قصة خاصة”

174 نقطتي الأستروولوجيا الهندية - أكثر من كل المجالات الغربية. السبب بسيط: الأستروولوجيا الهندية أكثر تطوراً. هناك، حيث الأستروولوجيا الغربية تتبع نفس مجموعة النقاط، الأستروولوجيا الهندية تتبع 16 التقسيمات-الخريطة (الوارجا)، العديد من أنظمة الداشات، عشرات القوائم مع القواعد الصارمة. كل واحد من هذا - نقطة حسابية مع النتائج المحددة.

إذا كنت تبني تحت السوق الهندي، هذا النواة من المنتج، وليس المكونات.

بما أن كل تقنية غريبة تتبع نفس النواة في حساب النجوم على Swiss Ephemeris (WASM). نفس النواة تعمل في المتصفح تطبيقنا، وفي خادم API - واحدة النواة، لا توجد فرق. نقطتي حساب تُغطي 873 التطبيقات التقييمية، التي يتم إعادة التقييم مع المصادر الأساسية في كل إصدار. تفاصيل أكثر حول هذا في المقالة الخاصة حول دقة التطبيق.

كيف العثور على النقطة المطلوبة

Section titled “كيف العثور على النقطة المطلوبة”

ثلاثة طرق، من الأسرع:

  1. مخطوطة OpenAPI - /docs/api/ يتم إنشاؤه مباشرة من المانيفست التطبيق على openapi.json. المجالات في القائمة الجانبية = المجالات أعلاه. كل نقطة حسابية تتبع نمط الجسم، مثال، و زر “جرب”.

  2. مخطوطة MCP - إذا كنت في Claude أو Cursor، كل المخطوطة متاحة كجموعة أدوات من خلال mcp.astroway.info. العميل نفسه يجد النقطة المطلوبة بناءً على الوصف.

  3. بحث في المانيفست - curl https://api.astroway.info/v1/openapi.json يؤدي إلى المانيفست الكامل للنواة. سهل للكودينيرجيرسي.

النقطة على dashboard/sign-up تمنح 10,000 نقطة حسابية شهريا - كافية لمرور في عشرات المجالات و فهم ماذا يوجد. لا توجب عليك تعلم المخطوطة بأكمله: اختر مجالتك، و الباقي ينتظر حتى يحتاج.

MakSeong · AstroWay

أبني AstroWay API: أُغلف Swiss Ephemeris في REST نقي وأكتب عن التفاصيل المملة التي هي فعلاً مهمة.

// ابنِ عليه

نفس Swiss Ephemeris الموجود في Solar Fire - في 4 أسطر من الكود.

مفتاح مجاني بدون بطاقة. 5000 استدعاء شهرياً حتى الدفعة الأولى.

المزيد من المدونة جميع المقالات →

Engineering 2026-07-15

ثلاثة SDK رسمية: TypeScript, Python, PHP بدلاً من curl الخام

HTTP الخام يعمل، لكن العميل المطبّق يوفّر ساعات: إكمال تلقائي للمسارات، أنواع الطلب والاستجابة، إعادة محاولة مدمجة على 408/409/429/5xx، وتسلسل أخطاء بنمط Stainless. نستعرض ثلاثة SDK رسمية - @astroway/sdk (npm)، astroway (PyPI)، astroway/sdk (Packagist) - وكيف تم توليدها من عقد OpenAPI واحد.

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.

Engineering 2026-06-05

Horoscope API Tutorial: Build a Daily Horoscope Feature

Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.