FAQ answers

عام

ما هو AstroWay API؟

واجهة HTTP API احترافية للحسابات الفلكية. 771 نقطة النهاية مبنية على Swiss Ephemeris: خرائط الولادة، السيناستري، التقدمات، التوجيهات، العبور، Human Design، الخرائط الفلكية، التصحيح، تفسيرات AI. جميع الحسابات تُجرى على الخادم - لا توجد أي تبعيات على جانب العميل.

لمن هذا الـ API؟

للمطورين الذين يبنون تطبيقات فلكية (ويب/موبايل)، شركات AI التي تضيف وظائف فلكية، الفلكيين المحترفين الذين يستخدمون سكريبتات، والباحثين الذين يحتاجون إلى وصول برمجي إلى الحسابات.

ما هي دقة الحسابات؟

Swiss Ephemeris يضمن دقة مواقع الكواكب إلى ±1 ثانية زاوية، نقاط كوسبيد المنازل إلى ±1 دقيقة زاوية. النتائج تم التحقق منها مقابل Astrodienst (Astro.com)، Solar Fire، Zet 9 و Kepler. انحراف أقل من ثانية قوسية مقارنة بـ NASA JPL ephemeris و NASA 5-Millennium Eclipse Catalog.

كيف يقارن AstroWay بـ Astro.com أو Solar Fire؟

محرك Swiss Ephemeris هو نفسه المستخدم في Solar Fire (رخصة $495)، Kepler ($995)، Astro Gold ($29.99/شهر) و Astrodienst (Astro.com). تم التحقق منه مقابل NASA JPL ephemeris والمرجع الرسمي swetest من Astrodienst. انحراف أقل من ثانية قوسية (≤0.1″) في مواقع الكواكب، ≤1 دقيقة في الكسوف. الفرق: AstroWay - REST API بسعر $5/شهر بدلاً من رخصة لمرة واحدة أو واجهة سطح مكتب.

ما أنظمة المنازل المدعومة؟

15 نظامًا: Placidus (الافتراضي)، Koch، Whole Sign، Equal، Regiomontanus، Campanus، Topocentric، Alcabitius، Morinus، Porphyrius، Vehlow، Krusinski-Pisa، Hindu Bhava، APC و Equal من MC. أرسل الرمز المناسب في المعامل houseSystem.

الائتمانات والدفع

كيف تعمل نظام الائتمان؟

كل نقطة نهاية لها تكلفة ثابتة بالائتمانات (من 10 إلى 500)، حسب تعقيد الحساب. lookup بسيط - 10، خريطة الولادة - 20، السيناستري - 50، التصحيح - 500. الجدول الكامل موجود على صفحة الأسعار.

هل هناك خطة مجانية؟

نعم. الخطة المجانية تمنح 10 000 ائتمان/شهر، 10 طلب/دقيقة. بدون إدخال بطاقة. كافية لتقييم المنتج وإنشاء نماذج أولية.

ماذا يحدث عندما تنفد الائتمانات؟

في الخطة المجانية - تُحظر الطلبات حتى الشهر التالي (429 CREDITS_EXHAUSTED). في خطط Indie/Starter/Pro/Business - يتم تطبيق رسوم إضافية: $5 / $3 / $2 لكل 10 000 ائتمان إضافي.

هل يتم تخزين الطلبات المتطابقة في الذاكرة المؤقتة؟

نعم. نفس الإدخال خلال 5 دقائق يُسترجع من الذاكرة المؤقتة دون خصم ائتمانات. يتم التأكيد عبر الرأس X-Cache: HIT.

هل يمكن شراء الائتمانات بدون اشتراك؟

ليس بعد. الاشتراك يوفر ميزانية متوقعة ومعدل طلبات أعلى. خطة Pay-as-you-go قيد التخطيط.

تقني

ما الـ SDK المتاحة؟

• خادم MCP ✅ зрелізено: npx -y @astroway/mcp: يعرّض جميع 771+ نقاط النهاية كأدوات لـ Claude Desktop، Cursor، GPT وغيرها من الوكلاء الذكاء الاصطناعي المتوافقين مع MCP
• TypeScript SDK ✅ зрелізено: npm install @astroway/sdk: الأنواع + الإكمال التلقائي من OpenAPI 3.1، إعادة المحاولة + عدم التكرار، أخطاء بنمط Stainless
• Python SDK ✅ зрелізено: pip install astroway: sync Astroway + async AsyncAstroway، مبني على httpx، مكتوب وفق PEP 561
• PHP SDK ✅ зрелізено: composer require astroway/sdk: PHP 8.1+، Guzzle 7 + PSR-18، middleware لإعادة المحاولة
• Go / Ruby / Rust 📋 مخطط: اشترك في الإشعارات عبر البريد الإلكتروني على صفحة كل SDK (/sdk/<language>/)

عقد الـ API - REST + JSON قياسي، لذا أي عميل HTTP يعمل بدون SDK. مجموعة Postman ومواصفات OpenAPI 3.1 متاحة للجمهور.

هل هناك وضع sandbox؟

نعم. المفاتيح aw_test_* لا تخصم ائتمانات وتعيد نفس النتائج. مثالية للتطوير والاختبار.

ما هو حد المعدل (rate limit)؟

يعتمد على الخطة: Free - 10، Indie - 30، Starter - 120، Pro - 400، Business - 1 000 طلب/دقيقة. عند تجاوز الحد - 429 مع الرأس Retry-After.

هل يتم دعم البروج الفلكي (sidereal)؟

نعم. أرسل "zodiacType": "sidereal" واختياريًا "ayanamsaId" (الافتراضي - Lahiri). يعمل مع جميع نقاط النهاية.

ما هي نقاط النهاية Human Design؟

12 نقطة نهاية لحساب Human Design: النوع، الاستراتيجية، السلطة، الملف، التعريف، الصليب التجسدي، القنوات، المراكز، Dream Rave، Hologenetic Profile، Penta (ديناميكيات المجموعة)، الحساسية الزمنية. أعمق تغطية لـ HD بين الـ API التجارية.

الأمان والخصوصية

هل يتم حفظ بيانات الطلبات؟

الـ API يعمل بدون حالة (stateless) - لا تُحفظ بيانات التاريخ/الوقت/إحداثيات الميلاد بعد معالجة الطلب. تُسجل فقط البيانات الوصفية: key_id، نقطة النهاية، timestamp، latency، الائتمانات. لا توجد بيانات شخصية.

هل يتوافق الـ API مع متطلبات GDPR؟

نعم. لا تُحفظ البيانات. للمستخدمين من الاتحاد الأوروبي: لا معالجة للبيانات الشخصية (PII)، لا استهداف، لا ملفات تعريف الارتباط. مفتاح الـ API مرتبط بالحساب، وليس بالمستخدم النهائي.

هل تفسيرات AI آمنة؟

نقاط النهاية AI (/interpret/*, /horoscope/*) تحتوي على حواجز أمان مدمجة: حظر النصائح الطبية، القانونية، المالية. كل إجابة تتضمن إخلاء مسؤولية. سجل تدقيق كامل - للامتثال المؤسسي.

الدعم

كيف تحصل على المساعدة؟

يعتمد على الخطة: Free - مجتمع، Indie - بريد إلكتروني (48 ساعة)، Starter - بريد إلكتروني (24 ساعة)، Pro - بريد إلكتروني (4 ساعات)، Business - بريد إلكتروني + Slack (1 ساعة)، Enterprise - مدير مخصص على Slack. جهات الاتصال - على صفحة الاتصال.

هل هناك SLA؟

Indie: 99% وقت تشغيل. Starter و Pro: 99.9% وقت تشغيل. Business: 99.95% وقت تشغيل. Enterprise: SLA مخصص مع ضمانات مالية.

أسماء مشابهة

هل يرتبط AstroWay API (astroway.info) بالاشتراك “Astroway” من astroway.life؟

لا. astroway.info و api.astroway.info - هما شركة منفصلة ومستقلة. نحن نقدم API فلكية للمطورين (api.astroway.info)، تطبيق للمستخدمين النهائيين (app.astroway.info) واستشارات فلكية. نحن ليس لدينا أي علاقة بالاشتراك الاستهلاكي الفلكي الذي يُعلن عنه ويُخصم تحت اسم “Astroway” عبر astroway.life (رسائل من no-reply@astroway.life، شخصية “Celeste”، في كشف الحساب البنكي - “Astroway”). مشغل هذا الاشتراك هو TrafficLeader OÜ (إستونيا، أيضًا traffic-leader.com); البائع المصاحب SKYREAD.PRO هو ABCMobile OÜ (إستونيا). التشابه فقط في نطق الاسم - هما شركتان مختلفتان.

يخصم مني “Astroway” - كيف أُلغِي الاشتراك وأسترد الأموال؟

1. رد مباشرة على الرسالة من no-reply@astroway.life واستخدم الرابط “إلغاء الاشتراك / إلغاء” في تذييلها.
2. إذا لم يردوا: تواصل مع مصرفك أو مصدر بطاقتك (الدفع في كشف الحساب - “Astroway”؛ التاجر - TrafficLeader OÜ أو ABCMobile OÜ / SKYREAD.PRO، إستونيا) واطلب حظر الخصومات المتكررة أو طلب استرداد (chargeback).