يضم كتالوج AstroWay الآن 865 نقطة نهاية في 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 وللرونات: يتغير المسار ومخطط الجسم فقط.
نطاقات الكتالوج
Section titled “نطاقات الكتالوج”يُجمَّع الكتالوج في نطاقات كبيرة. هذه خريطة بأعداد حقيقية (تُؤخذ الأرقام من الـ manifest في كل بناء، لذلك تكون هنا محدّثة دائمًا):
| النطاق | نقاط النهاية | ما بداخله |
|---|---|---|
| التنجيم الغربي | 186 | خريطة الميلاد، والجوانب، والكرامات، والتنبؤ (العبورات، والتقدمات، والتوجيهات)، وhorary، و4 مدارس هلنستية، والتنجيم النفسي الحديث، والتطوري، والكوزموبيولوجيا |
| الفيدي | 230 | أكبر نطاق: nakshatras، وdashas، والخرائط التقسيمية (varga)، وyogas، وdosha، وJaimini، وKP، وashtakavarga، وshadbala |
| Human Design | 12 | مخطط الجسم (bodygraph)، والقنوات، والبوابات، والنوع/الملف/السلطة، والصليب التجسدي |
| التاروت | 71 | ثلاث مجموعات أوراق: Rider-Waite-Smith وMarseille وLenormand، مع الانتشارات والمعاني والتوليفات |
| علم الأعداد | 55 | 5 أنظمة بعشر حسابات لكل منها (الفيثاغوري، والكلداني، واثنان قبّاليان، والفيدي) |
| الصيني والمايا | 55 | BaZi (الأعمدة الأربعة)، وZi Wei Dou Shu، والأبراج الصينية والفنغ شوي، وتقاويم المايا |
| العِرافة | 40 | الجيومانسي (Agrippa)، ورونات Elder Futhark، وقراءة الكف (Cheiro)، وI Ching |
| مجالات تطبيقية | 53 | Wellness، وتنجيم الحيوانات الأليفة، والأعمال، والمال، والعائلة |
| التقارير | 29 | تفسيرات جاهزة (natal، synastry) بصيغة HTML/PDF، مع علامة تجارية white-label |
| الرسم | 14 | عجلات الخرائط وbodygraph والحلقات العبورية بصيغة SVG/PNG، دون واجهة أمامية خاصة بك |
| أدوات المطوّر | 47 | Webhooks، والبث في الوقت الفعلي، والودجات القابلة للتضمين، وwhite-label |
الباقي: تفسيرات AI، والأبراج اليومية، ونقاط نهاية مرجعية (الأبراج، والكواكب، والجوانب)، ونقاط نظامية (health، usage، openapi).
الفيدي قصة منفصلة
Section titled “الفيدي قصة منفصلة”230 نقطة نهاية فيدية، أي أكثر من الجزء الغربي بأكمله. والسبب بسيط: التقليد الفيدي أكثر صياغةً رسمية. فحيث يملك التنجيم الغربي مجموعة واحدة من البيوت، يملك الفيدي 16 خريطة تقسيمية (varga)، وعدة أنظمة dasha، وعشرات yogas بقواعد واضحة. وكل واحد من هذه نقطة نهاية مستقلة بنتيجة حتمية.
إذا كنت تبني للسوق الهندي، فهذا جوهر المنتج وليس إضافة.
الدقة تحت كل ذلك
Section titled “الدقة تحت كل ذلك”مهما كانت التقنية غريبة، تُحسب مواقع الكواكب بنواة واحدة مبنية على Swiss Ephemeris. النواة نفسها تعمل في تطبيقنا وفي الـ API: قاعدة كود واحدة، دون أي اختلاف. نقاط النهاية الحسابية مغطاة بـ 888 اختبار snapshot تُطابَق مع مصادر مرجعية في كل PR. التفاصيل في مقالة منفصلة عن دقة CI.
كيف تجد ما تحتاجه
Section titled “كيف تجد ما تحتاجه”ثلاثة طرق، من الأسرع:
- مرجع OpenAPI: /docs/api/ يُولَّد مباشرةً من مواصفة الإنتاج
openapi.json. المجموعات في الشريط الجانبي = النطاقات أعلاه. لكل نقطة نهاية مخطط للجسم، ومثال، وزر “جرّب”. - كتالوج MCP: إذا كنت في Claude أو Cursor، فالكتالوج كله متاح كمجموعة أدوات عبر
mcp.astroway.info. يجد الوكيل نقطة النهاية المطلوبة بنفسه من الوصف. - البحث في المواصفة:
curl https://api.astroway.info/v1/openapi.jsonيعيد العقد الكامل القابل للقراءة آليًا. مفيد لتوليد عميلك الخاص بالكود.
المفتاح من dashboard/sign-up يمنحك 10 000 رصيد شهريًا، وهذا يكفي لتجربة عشرات النطاقات ومعرفة ما يناسبك منها. لا حاجة لدراسة الكتالوج كله: خذ نطاقك، والباقي سينتظر إلى أن تحتاجه.
مواقع بدقة الثانية القوسية في 4 أسطر من الكود.
مفتاح مجاني بدون بطاقة. 5000 استدعاء شهرياً حتى الدفعة الأولى.