توثيق AstroWay API
مركز التوثيق التقني لـ AstroWay API. 781 نقطة نهاية مبنية على Swiss Ephemeris، ومواصفة OpenAPI قابلة للقراءة آليًا، ومجموعات جاهزة لـ Postman وInsomnia، وحزم SDK رسمية لـ TypeScript وPython وPHP، وخادم MCP لـ Claude/Cursor.
المرجع
Section titled “المرجع” API Reference كتالوج كامل لـ 781 نقطة نهاية: المعاملات، ومخططات الاستجابات، ورموز الأخطاء. يُولَّد من مواصفة OpenAPI مع كل إصدار.
OpenAPI specification مواصفة قابلة للقراءة آليًا. استوردها في Postman/Insomnia أو ولّد SDK خاصًا بك عبر openapi-generator.
Postman collection مجموعة جاهزة للاستيراد مع أمثلة لكل نقطة نهاية.
Per-endpoint cost التكلفة بالأرصدة لكل نقطة نهاية، من 0 إلى 500 رصيد.
البداية
Section titled “البداية” البدء السريع سجّل، واحصل على مفتاح، ونفّذ أول استدعاء خلال 5 دقائق.
المصادقة X-Api-Key مقابل Bearer، وlive (aw_live_*) مقابل sandbox (aw_test_*)، وJWT للوحة التحكم.
الأرصدة والحدود تجميع الأرصدة، والحصص الشهرية، وrate limits حسب الخطة.
دعم اللغات 21 لغة مفعّلة. توطين الاستجابات عبر `Accept-Language` (المحتوى النصي).
حزم SDK والتكاملات
Section titled “حزم SDK والتكاملات” TypeScript SDK الحزمة الرسمية `@astroway/sdk` على npm. ESM، وNode 20+، ومتوافقة مع المتصفح.
Python SDK الحزمة الرسمية `astroway` على PyPI. عملاء متزامنون وغير متزامنين، Python 3.9+.
PHP SDK الحزمة الرسمية `astroway/sdk` على Packagist. PSR-18 HTTP، PHP 8.1+.
MCP server `@astroway/mcp`: خادم Model Context Protocol لـ Claude Desktop وCursor ووكلاء AI آخرين.
الهندسة
Section titled “الهندسة” دقة الحسابات دقة Swiss Ephemeris على مستوى الثانية القوسية. اختبارات CI-snapshot مقابل NASA Eclipse Catalog.
الأخطاء قائمة error codes وحالات HTTP وبنية error envelope.
Idempotency الترويسة `Idempotency-Key` لإعادة المحاولة بأمان في طلب��ت POST.
إدارة الإصدارات كيف نرفع الإصدارات، وما الذي يكسر التوافق، وكيف تقرأ changelog.
السيناريوهات والأمثلة
Section titled “السيناريوهات والأمثلة” نظرة عامة على المنتجات أربع مجموعات منتجات: Birth Chart وHuman Design وSynastry وHoroscope.
علم التنجيم الفيدي أكثر من 354 نقطة نهاية للتنجيم الفيدي: Vargas، وdashas (8 أنظمة)، وPanchang، وShadbala، وYogas، وDoshas.
أمثلة الكود مقتطفات جاهزة لخريطة الميلاد، والتوافق (synastry)، والعبورات، وHuman Design، وMCP.
Use cases سيناريوهات تكامل لتطبيقات التنجيم، ووكلاء AI، ومنصات المواعدة.