# بناءً على واجهة برمجة التطبيقات الفلكية AstroWay

Source: https://astroway.info/ar/developers/
Language: ar
Updated: 2026-05-28

فلكي API · v1

700+ نقطة نهاية، ثلاثة حزم برمجية خاصة، دقة Swiss Ephemeris. باقة مجهولة الهوية - ابدأ بدون مفتاح.

[الحصول على مفتاح مجاني](https://api.astroway.info/dashboard/sign-up) البداية السريعة بدون بطاقة · 10K رصيد/شهري

## البداية السريعة

احصل على توقعات يومية بدون مفتاح API:

```
curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
```

### سجّل مفتاحًا مجانيًا

[احصل على مفتاح مجاني - 10K ائتمان/شهر، بدون بطاقة](https://api.astroway.info/dashboard/sign-up)

### الطلب الأول باستخدام مفتاحك

```
curl -G "https://api.astroway.info/v1/chart" \
-H "X-Api-Key: aw_live_…" \
--data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
--data-urlencode "lat=50.45" --data-urlencode "lon=30.52"
```

انظر [الأسعار](https://astroway.info/shop/) لحدود الرسوم والتكلفة الائتمانية لكل نقطة نهاية.

## المصادقة

ثلاثة باقات. اختر الباقة الخاصة بك.

| التعرفة | المصادقة | الحدود | برج مائي |
| --- | --- | --- | --- |
| **مجهول** | بدون مفتاح | فقط /v1/embed/* · 30 طلب/ساعة لكل IP | نعم |
| **مفتاح مجاني** | `X-Api-Key: aw_live_…` | 10K رصيد/شهر | نعم |
| **مدفوع** | `X-Api-Key: aw_live_…` | Indie 50 ألف / Starter 200 ألف / Pro 800 ألف / Business 3.5 مليون | لا (Pro+) |

### ربط النطاق

تُربط المفاتيح المدفوعة بنطاق واحد عند أول طلب. يمكن تغييره بنفسك من لوحة التحكم، بحد أقصى 3 مرات شهريًا. تثبيت إضافة WordPress يرسل تلقائيًا الترويسة X-AstroWay-Site-URL دون الحاجة إلى تعديل الكود.

### معالجة الأخطاء

- `401` — مفقود أو غير صالح X-Api-Key
- `402` — الرسوم لا تشمل هذا نقطة النهاية (مثلاً: نقطة النهاية HD بدون حزمة HD)
- `403` — عدم تطابق النطاق (النطاق المرتبط ≠ رأس المصدر)
- `429` — تم تجاوز حد الطلبات أو استهلاك الاعتمادات الشهرية (تم تعيين رأس Retry-After)

## الإضافات المدمجة

iframe مباشر - يعمل على أي موقع HTML، بدون محمل JS. الخطة مجهولة الهوية، 30 طلب/ساعة لكل عنوان IP زائر.

### التنجيم اليومي

```
<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
width="100%" height="320" loading="lazy" frameborder="0"></iframe>
```

### عجلة المخطط المولود

```
<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
width="600" height="600" loading="lazy" frameborder="0"></iframe>
```

### بطاقة التارو اليومية

```
<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
width="400" height="500" loading="lazy" frameborder="0"></iframe>
```

### طور القمر

```
<iframe src="https://api.astroway.info/v1/embed/moon-phase"
width="320" height="320" loading="lazy" frameborder="0"></iframe>
```

### التثبيت على ووردبريس

قم بتثبيت [إضافة AstroWay لـ WP ↗](https://wordpress.org/plugins/astroway/) - أدوات Tier 1 بدون إعدادات، أكواد قصيرة للنسخ، مفتاح API اختياري لـ Tier 2/3.

## الرسمية SDK

ثلاثة حزم برمجية خاصة. سلامة نوع كاملة، مُنشأة من OpenAPI 3.1. ترخيص MIT. مع إعادة المحاولات، Idempotent.

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
npm install @astroway/sdk
```

```
import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · تم إنشاؤه من OpenAPI 3.1

### Python

astroway · v1.1.0

```
pip install astroway
```

```
from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
datetime="1990-06-15T14:30:00+03:00",
lat=50.45, lon=30.52,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · sync + async · نماذج Pydantic · py.typed

### PHP

astroway/sdk · v1.1.0

```
composer require astroway/sdk
```

```
use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · عميل HTTP PSR-18 · وعد Guzzle

### WordPress

هل موقعك على WordPress؟ الإضافة المجانية [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) تضيف المواليد، التنجيم، التارو، الأرقام، و Human Design عبر الأكواد القصيرة وكتلة Gutenberg - بدون كود. تعمل بشكل مجهول أو مع مفتاح API الخاص بك.

```
[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]
```

### LLM / وكلاء الذكاء الاصطناعي

نحن ننشر [/llms.txt ↗](https://api.astroway.info/llms.txt) لاكتشافها بواسطة وكلاء الذكاء الاصطناعي. مجموعة نقاط النهاية `/v1/context/*` تعيد XML محسّن لـ LLM للاستهلاك المباشر من خلال تكاملات ChatGPT / Claude / Gemini.

### خادم MCP (Pro+)

خادم Model Context Protocol الأصلي على mcp.astroway.info - قم بتوصيل Claude Desktop أو أي عميل MCP للاستعلام عن كامل API في وضع الحوار. متضمن في الباقات الاحترافية والتجارية.
