# API التوقعات الفلكية وتفسيرات AI

10 نقاط الذكاء الاصطناعي — جزء من أكثر من 700 نقطة نهاية في منصة AstroWay بالكامل (16 فئة). 5 منها خاصة بالتوقعات (يومية، أسبوعية، شهرية، سنوية، توافق) و5 أخرى للتفسيرات (نatalina، سيناستريا، ترانزيت، عنصر، وضع). جميعها مبنية على حسابات حقيقية من Swiss Ephemeris (نفس النظام المستخدم في Solar Fire وAstrodienst) — وليس على قوالب أو هلوسات LLM.

## كيف تعمل

1. يحسب API خريطة فلكية حقيقية (ترانزيت، ناتال، سيناستريا) عبر Swiss Ephemeris
2. يتم إرسال النتيجة إلى بوابتنا AI فوق أفضل نماذج السوق (Google Gemini → Groq Llama 3.3 → OpenRouter مع GPT-4 / Claude / DeepSeek → Cerebras → SambaNova → Mistral) مع نظام prompt فلكي وفشل تلقائي
3. يولد LLM نصًا مع حماية أمان مدمجة (حظر النصائح الطبية والقانونية والمالية)
4. تتضمن الاستجابة إخلاء مسؤولية وسجل تدقيق

<Aside type="tip">
ترجع نقاط الذكاء الاصطناعي الحسابات والنصوص. يمكنك استخدام الحسابات فقط (نقاط نهاية أرخص) وتوليد النص باستخدام LLM الخاص بك.
</Aside>

## نقاط النهاية — التوقعات

| نقطة النهاية | الاعتمادات | ما تولده |
|---|---|---|
| `/v1/horoscope/daily` | 20 | توقعات يومية بناءً على الترانتز الحالي |
| `/v1/horoscope/weekly` | 20 | مراجعة أسبوعية |
| `/v1/horoscope/monthly` | 20 | توقعات شهرية |
| `/v1/horoscope/yearly` | 50 | توقعات سنوية |
| `/v1/horoscope/compatibility` | 50 | تحليل نصي للتوافق |

## نقاط النهاية — التفسيرات

| نقطة النهاية | الاعتمادات | ما تفسره |
|---|---|---|
| `/v1/interpret/natal` | 50 | تفسير كامل للخريطة الناتالية |
| `/v1/interpret/synastry` | 50 | تفسير السيناستريا |
| `/v1/interpret/transits` | 50 | تفسير الترانتز الحالي |
| `/v1/interpret/element` | 20 | تفسير عنصر واحد (كوكب في برج، ارتباط) |
| `/v1/interpret/placement` | 20 | تفسير الوضع (كوكب في منزل) |

## مثال

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/horoscope/daily \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/horoscope/daily', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        timezoneOffset: 3,
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data: horoscope } = await r.json();
    console.log(horoscope.text);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/horoscope/daily',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'timezoneOffset': 3,
            'latitude': 50.4501,
            الوثيقة
        },
    )
    horoscope = r.json()['data']
    print(horoscope['text'])
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('horoscope/daily', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $horoscope = json_decode($r->getBody(), true)['data'];
    echo $horoscope['text'];
    ```
  </TabItem>
</Tabs>

## حماية الأمان

تحتوي جميع نقاط الذكاء الاصطناعي على حماية مدمجة:

- **نظام prompt** يحظر صراحة تقديم نصائح طبية أو قانونية أو مالية
- **إخلاء مسؤولية تلقائي** في كل استجابة
- **فلتر المحتوى** — تصفية لاحقة للكلمات الرئيسية
- **سجل التدقيق** — تسجيل الـprompts والاستجابات (احتفاظ 90 يومًا)
- **`disclaimer_inline: true`** — معلمة للمؤسسات التي تريد النص مع إخلاء المسؤولية مسبقًا

<Aside type="caution">
مخصصات الذكاء الاصطناعي للتسلية فقط. لا تغني عن استشارة عالم فلك أو طبيب أو محامي أو مستشار مالي محترف.
</Aside>

## من يستخدم

- **منصات المحتوى** — توقعات يومية لجماهيرها
- **تطبيقات التنجيم** — تفسيرات مخصصة بدلاً من النصوص العامة
- **وكلاء الذكاء الاصطناعي** — عبر خادم MCP أو استدعاء مباشر لـAPI
- **الإعلام** — توليد محتوى فلكي بناءً على بيانات حقيقية

## التكلفة

التوقعات اليومية — **20 اعتماد**. تفسير كامل للخريطة الناتالية — **50 اعتماد**. في الخطة المجانية، يمكنك الحصول على 250 توقعات يومية أو 100 تفسير شهريًا.

<CardGrid>
  <LinkCard title="البدء السريع →" href="/getting-started/" description="أول طلب في 5 دقائق" />
  <LinkCard title="وكلاء الذكاء الاصطناعي وMCP" href="/use-cases/ai-agents/" description="دمج مع Claude، ChatGPT" />
  <LinkCard title="الخطط" href="/pricing/" description="من مجاني إلى مؤسسة" />
</CardGrid>