ملاحظات هندسية.
حول دقة الإفراميريس، بنية الحسابات، بروتوكول MCP، وكل التفاصيل الصغيرة التي لا تتناسب مع الوثائق.
الوثائق المصممة للوكلاء الذكاء الاصطناعي، وليس فقط للبشر
الوثائق الكلاسيكية مصممة للعين البشرية: HTML جميل، تظليل الكود، تنقل. لكن الآن نصف حركة المرور إلى docs هو الوكلاء والمساعدون الذين يحتاجون إلى plain-text، وليس إلى عرض. نستعرض ما أضفنا: نسخة .md لكل صفحة، llms.txt، مواصفات قابلة للقراءة آليًا، dropdown "فتح في ChatGPT / Claude" و inline try-it.
اقرأ →علم الأعداد في API: 5 أنظمة حساب عبر مسار واحد
معظم API إما لا يحتوي على علم الأعداد على الإطلاق، أو يقدم نظامًا فيفيغوريًا واحدًا. لدينا 5 أنظمة كاملة (فيفيغوري، حمادي، نظامان كابالي، هندوسي) كل منها 10 حسابات، عبر مسار واحد معلمات. بالإضافة إلى مصفوفة القدر لـ 22 أركانا.
اقرأ →المخرجات المكتوبة للنوع MCP: لماذا 600+ أداة لديها outputSchema
معظم خوادم MCP تُرجع JSON غير مكتوب للنوع للوكيل - يجب على النموذج تخمين شكل الاستجابة. نحن ننشر outputSchema صارم لـ 600+ أداة. نحلل كيف يعمل هذا، وما العيب الذي فتحه في عملاء وضع الصارم، وكيف أصلحناه عبر المخططات المفتوحة.
اقرأ →خريطة الكتالوج: كيف تُنظَّم أكثر من 700 نقطة نهاية في AstroWay
نما الـ API إلى أكثر من 700 نقطة نهاية في 57 مجموعة، من خريطة الميلاد إلى BaZi والجيومانسي ورسم خرائط SVG. نشرح كيف قُسِّم الكتالوج إلى نطاقات، والنمط الموحّد الذي تتبعه جميع الاستدعاءات، وكيف تجد نقطة النهاية المطلوبة بسرعة.
اقرأ →كيف نُبقي الدقة تحت السيطرة: CI مقابل swetest وNASA
الدقة في API فلكي تتدهور بسهولة بسبب إعادة هيكلة واحدة لكود الإفيمريس. نستعرض آليات الحماية: نواة Swiss Ephemeris واحدة للتطبيق والـ API، ومئات اللقطات المجمَّدة على خرائط مرجعية، ومقارنة ثلاثية لكل PR مع swetest CGI وKerykeion وProkerala وكتالوج الكسوفات لدى NASA.
اقرأ →ثلاث حزم SDK رسمية: TypeScript وPython وPHP بدل curl الخام
HTTP الخام يعمل، لكن العميل ذا الأنواع يوفّر ساعات: إكمال تلقائي للمسارات، وأنواع للطلب والاستجابة، وإعادة محاولة مدمجة عند 408/409/429/5xx، وتسلسل أخطاء بأسلوب Stainless. نستعرض ثلاث حزم SDK رسمية، @astroway/sdk (npm) وastroway (PyPI) وastroway/sdk (Packagist)، وكيف وُلِّدت من عقد OpenAPI واحد.
اقرأ →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.
اقرأ →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.
اقرأ →