How we build the API.
Internals, postmortems, and design decisions. Everything we wish someone had written down before we had to figure it out the hard way.
علم الأعداد في API: 5 أنظمة حساب عبر مسار واحد
معظم API إما لا يحتوي على علم الأعداد على الإطلاق، أو يقدم نظامًا فيفيغوريًا واحدًا. لدينا 5 أنظمة كاملة (فيفيغوري، حمادي، نظامان كابالي، هندوسي) كل منها 10 حسابات، عبر مسار واحد معلمات. بالإضافة إلى مصفوفة القدر لـ 22 أركانا.
خريطة الكتالوج: كيف تُنظَّم أكثر من 700 نقطة نهاية في AstroWay
نما الـ API إلى أكثر من 700 نقطة نهاية في 57 مجموعة، من خريطة الميلاد إلى BaZi والجيومانسي ورسم خرائط SVG. نشرح كيف قُسِّم الكتالوج إلى نطاقات، والنمط الموحّد الذي تتبعه جميع الاستدعاءات، وكيف تجد نقطة النهاية المطلوبة بسرعة.
ثلاث حزم SDK رسمية: TypeScript وPython وPHP بدل curl الخام
HTTP الخام يعمل، لكن العميل ذا الأنواع يوفّر ساعات: إكمال تلقائي للمسارات، وأنواع للطلب والاستجابة، وإعادة محاولة مدمجة عند 408/409/429/5xx، وتسلسل أخطاء بأسلوب Stainless. نستعرض ثلاث حزم SDK رسمية، @astroway/sdk (npm) وastroway (PyPI) وastroway/sdk (Packagist)، وكيف وُلِّدت من عقد OpenAPI واحد.
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.
Natal Chart API in PHP: SDK + Laravel Example
Compute a natal chart in PHP with the AstroWay SDK - plain PHP and a Laravel facade - without compiling a Swiss Ephemeris extension.
Natal Chart API in Python: 3 Examples with the AstroWay SDK
How to compute a natal chart in Python via API - install, first request, transits and synastry - with working code and how it compares to pyswisseph and kerykeion.
Natal Chart API in TypeScript: SDK + React Example
Compute a natal chart in TypeScript with the AstroWay SDK - typed responses, a React component, and where it beats a local ephemeris library.
X-Cache header: حالة cache-status المرئية لتحسين تكاملات العملاء
كل استجابة API الآن تحمل X-Cache: MISS | HIT | BYPASS - العميل يرى فورًا ما إذا كان الطلب محسوبًا من الصفر أم مستخرجًا من الذاكرة المؤقتة. هذا يفتح عمود نسبة cache hit % في /dashboard/usage ويسمح بتحسين التكامل دون تخمين.
Reports V2: endpoint واحد بدلاً من اثني عشر - `/v1/reports/generate`
بدلاً من 12 type-specific route /reports/natal, /reports/synastry, … - endpoint موحد واحد POST /v1/reports/generate مع حقل report_type. مستهلكو SDK يحصلون على طريقة واحدة بدلاً من اثني عشر؛ دليل MCP يتقلص من 12 أداة إلى واحدة.
علم التنجيم الفيدي عبر API: من باراشارا إلى Lal Kitab في 354 نقطة نهاية
يقدّم AstroWay الآن أشمل تغطية فيدية بين واجهات API التجارية: 10 أنظمة dasha، و16 varga، والـ Panchang، و Lal Kitab كاملًا مع KP و Jaimini. كيف يعمل ذلك، ومتى تختار كل تقنية.
White-label PDF بدون WordPress: inline branding عبر حقل واحد
حقل whitelabel في مخططات جميع 12 نقطة النهاية /v1/reports/* يقبل الآن ليس فقط boolean (قراءة DB-config) ولكن أيضًا inline-object مع 15 حقلًا. هذا يزيل الربط بـ WordPress-user - أي SaaS API consumer يمكنه علامة PDF على الفور، بدون صفحة admin منفصلة.
كيفية بناء تطبيق فلكي: دليل كامل للمطور
دليل خطوة بخطوة لإنشاء تطبيق فلكي من الصفر - اختيار API، هندسة، الخارطة Natal الأولى، إضافة سيناستري وانتقالات، نشر.
بدء سريع مع API الفلك: TypeScript و Python في 5 دقائق
تثبيت SDK، الحصول على مفتاح API، إجراء طلب الخارطة Natal الأولى. 5 دقائق - و JSON يعمل في يديك (TypeScript و Python).
API التصحيح: تصحيح وقت الميلاد للمطورين
التصحيح هو عملية تحديد وقت الميلاد غير المعروف أو غير الدقيق من خلال أحداث الحياة. في هذا المنشور - كيفية تلقيمه عبر API باستخدام الطريقة الخوارزمية و Trutine of Hermes.
نفس Swiss Ephemeris الموجود في Solar Fire - في 4 أسطر من الكود.
مفتاح مجاني بدون بطاقة. 5000 استدعاء شهرياً حتى الدفعة الأولى.