SDK · AstroWay لجميع اللغات

مُصدَر

// صيانة بواسطة AstroWay · تزامن OpenAPI في نفس اليوم

MCP المستضاف - بدون تثبيت مسبق لـ Claude Web / Desktop / Cursor

نقطة نهاية HTTP قابلة للاستضافة عبر mcp.astroway.info/mcp - نفس مجموعة الأدوات 700+ مثل حزمة npm، بدون تثبيت محلي. رابط واحد، رأس Bearer واحد، ويمكن لعميل الذكاء الاصطناعي رؤية النظام البيئي الكامل لـ AstroWay. متعدد المستأجرين: يتم سحب الاعتمادات من الحساب الذي يمتلك مفتاح Bearer الخاص بك.

https://mcp.astroway.info/mcp اقرأ دليل SDK →

mcp مُصدَر

خادم MCP (stdio) لـ Claude / Cursor / GPT

الرسمي @astroway/mcp: يعرض جميع نقاط نهاية API الـ 700+ الخاصة بـ AstroWay كأدوات لعملاء الذكاء الاصطناعي. يعمل مع Claude Desktop و Cursor و عملاء GPT MCP. وضع stdio - يبقى مفتاحك على جهازك، بدون قفزات شبكة. للاستخدام بدون تثبيت، استخدم نقطة النهاية المستضافة بدلاً من ذلك.

npx -y @astroway/mcp اقرأ دليل SDK →

typescript مُصدَر

SDK TypeScript لواجهة AstroWay API

الـ@astroway/sdk الرسمي - غلاف خفيف فوق openapi-fetch (~6 كيلوبايت runtime). إكمال المسار التلقائي + أنواع الطلبات/الاستجابات في بيئتك التطويرية لجميع 771+ endpoints. تسلسل أخطاء على نمط Stainless، إعادة محاولة مدمجة على 408/409/429/5xx، OIDC + SLSA L3 أصل.

npm install @astroway/sdk اقرأ دليل SDK →

python مُصدَر

Python SDK ل AstroWay API

الرسمي astroway على PyPI - Astroway (متزامن) + AsyncAstroway (غير متزامن) على قمة httpx. سطح متطابق - نفس API على كلا العميلين. هرمية أخطاء من نمط Stainless، إعادة تشغيل على 408/409/429/5xx، حزمة PEP 561 نمطية. Python 3.9+، Trusted Publisher OIDC.

pip install astroway اقرأ دليل SDK →

php مُصدَر

SDK PHP ل AstroWay API

الرسمي astroway/sdk على Packagist - مبني على Guzzle 7 + PSR-18. PHP 8.1+ (خصائص للقراءة فقط، تعزيز البناء). هرمية أخطاء من نمط Stainless، وسيط إعادة المحاولة مدمج على 408/409/429/5xx، مخططين للتحقق من الصحة (X-Api-Key افتراضي أو Bearer).

composer require astroway/sdk اقرأ دليل SDK →

react مُصدَر

رفيق React لـ @astroway/sdk

الرسمي @astroway/react على npm - غلاف رقيق Stripe-STYLE فوق @astroway/sdk. يرفع AstrowayProvider العميل إلى سياق React؛ hooks useAstroway و useAstrowayQuery و useNatalChart ترجع ثلاثية SWR-STYLE { data, error, loading } مع لا依赖ات خارجية. يعمل مع React 18+، Next.js App Router (من خلال "use client")، Vite، CRA.

npm install @astroway/react @astroway/sdk react اقرأ دليل SDK →

ui مُصدَر

مكوّنات الويب AstroWay (ألفا)

عجلة الميلاد، مرحلة القمر، التوافق، التارو والأبراج كعناصر HTML عادية لأي موقع: وسم <script> واحد من CDN، أو npm install. الرسوم تُرسم بنفس الكود كما في API، لذا العجلة على صفحتك تطابق ما تُرجعه /v1/render. ألفا: قد تتغيّر أسماء السمات قبل 1.0.

npm install @astroway/ui@alpha اقرأ دليل SDK →

symfony مُصدَر

حزمة Symfony لبروتوكول AstroWay API

الرسمي astroway/sdk-symfony على Packagist - حزمة على رأس astroway/sdk. تسجيل ذاتي عبر Symfony Flex، ومُضبط عبر الملف القياسي config/packages/astroway.yaml، وتعرض خدمة Astroway\Astroway قابلة للحقن في أي متحكم أو خدمة. متوافق مع Symfony 6.4 LTS و 7.x، PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha اقرأ دليل SDK →

laravel مُصدَر

Laravel ServiceProvider ل AstroWay API

الرسمي astroway/sdk-laravel على Packagist - مزود خدمة + واجهة برمجة تطبيقات على مستوى astroway/sdk. يتم اكتشافه تلقائيًا عبر composer.json extra.laravel.providers ، Astroway\Astroway مسجل كsingleton حاوية ، config منشور عبر php artisan vendor:publish. الحقن في المُحَوِّلات أو استخدام الواجهة Astroway::post("/chart", ...). يعمل مع Laravel 10/11/12، PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha اقرأ دليل SDK →

go مُصدَر

SDK بلغة Go لواجهة AstroWay API

وحدة Go الرسمية من AstroWay: كل endpoint في الـ API كدالة، مثل aw.Chart.Compute، مع context في كل استدعاء. إعادة المحاولة عند 408/409/429/5xx تحترم Retry-After، وطلب POST يحتفظ بمفتاح Idempotency-Key واحد، لذا الاستدعاء المُعاد لا يُحتسب مرتين. تُختبر الأخطاء باستخدام errors.Is، وتُفكّ الاستجابة إلى النوع الخاص بك. المكتبة القياسية فقط، Go 1.22+.

go get github.com/astroway/astroway-go اقرأ دليل SDK →

csharp مُصدَر

SDK C# لواجهة برمجة تطبيقات AstroWay

Package Astroway.Sdk: كل نقطة نهاية API كطريقة async، مثل aw.Chart.ComputeAsync، يمكن إلغاؤها باستخدام CancellationToken. إعادة المحاولة عند 408/409/429/5xx تحترم Retry-After، كل نوع من الأخطاء له استثناء خاص به، والاستجابة تُفكّ شيفرتها إلى سجلاتك الخاصة. .NET Standard 2.0 و .NET 8: .NET Framework 4.7.2+، .NET 6/8/9، Unity.

dotnet add package Astroway.Sdk اقرأ دليل SDK →

4 أسطر للوصول إلى أول طلب

// TypeScript · نفس النمط في Python، PHP، Laravel، Symfony، React

npm install @astroway/sdk مثال كامل →

import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const { data: chart } = await aw.client.POST('/chart', {
  body: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  },
});

// aw.client.POST is the raw typed fetch, so `chart` is the { ok, data } envelope
console.log(chart.data.houses.ascendant);  // 212.0952574979425