# API الخارطة الميلادية

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/chart \
      -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,
        "houseSystem": "P"
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/chart', {
      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,
        houseSystem: 'P',
      }),
    });
    const { data: chart } = await r.json();
    console.log(`ASC: ${chart.angles.asc.sign} ${chart.angles.asc.degree.toFixed(2)}°`);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/chart',
        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,
            'longitude': 30.5234,
            'houseSystem': 'P',
        },
    )
    chart = r.json()['data']
    print(f"ASC: {chart['angles']['asc']['sign']} {chart['angles']['asc']['degree']:.2f}°")
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('chart', [
        '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,
            'houseSystem': 'P',
        ],
    ]);
    $chart = json_decode($r->getBody(), true)['data'];
    printf("ASC: %s %.2f°\n", $chart['angles']['asc']['sign'], $chart['angles']['asc']['degree']);
    ```
  </TabItem>
</Tabs>

## ماذا يتم حسابه

تشتمل الخريطة الناطقة الكاملة على **الثالوث الفلكي** — الأبعاد الثلاثة للشخصية التي يدرسها المستخدمون باستمرار (مما يزيد من الت retention):

- **مواقع الكواكب** — الشمس (الهوية/الغرض)، القمر (القلب العاطفي/الحاجات)، عطارد، الزهرة، المريخ، المشتري، زحل، أورانوس، نبتون، بلوتو + العقدة الشمالية، كايرون. الطول، العرض، السرعة، البرج، البيت، التراجع.
- **أبراج البيوت** — 15 نظامًا للاختيار من بينها (بلاسيدس، كوخ، الأبراج الكاملة، المتساوية وغيرها). ASC (كيف يراك الآخرون)، MC (المهنة/الصورة العامة)، فيرتكس.
- **الترابطات** — الاقتران، المعارضة، المثلث، المربع، السدس، الكوينكونكس. المدار، التطبيق/الانفصال.
- **قطاع الخريطة** — نهاري/ليلي (للأسلوب الكلاسيكي الهلنستي على غرار Chris Brennan / Demetra George).

## نقاط النهاية

| نقطة النهاية | الاعتمادات | ما تُعيده |
|---|---|---|
| `/v1/chart` | 20 | الخريطة الناطقة الكاملة (كواكب + بيوت + ترابطات) |
| `/v1/planets` | 10 | مواقع الكواكب فقط (بدون بيوت أو ترابطات) |
| `/v1/essential-dignities` | 20 | جدول الدرجات الأساسية (المسكن، الارتفاع، المثلث، الحد، الوجه) |
| `/v1/almuten` | 20 | ألموتن فيجوريس — تقنية العصور الوسطى |
| `/v1/arabic-parts` | 20 | الأجزاء العربية/الأنصبة (فورتونا، الروح وغيرها) |
| `/v1/fixed-stars` | 20 | اقترانات الكواكب مع النجوم الثابتة |
| `/v1/midpoints` | 20 | أنصاف النقاط الكوكبية |
| `/v1/disposition-chains` | 20 | سلاسل التبعية (رسوم التحكم) |
| `/v1/firdaria` | 20 | فترات الفيردارية |
| `/v1/profections` | 20 | الترقيات السنوية |
| `/v1/planetary-phases` | 20 | المراحل الشرقية/الغربية |
| `/v1/receptions` | 20 | الاستقبال المتبادل |

## من يستخدم

- **تطبيقات التنجيم** — تطبيقات الويب والجوال التي تبني الخرائط
- **وكلاء الذكاء الاصطناعي** — عبر خادم MCP أو `/interpret/natal` للتفسيرات بواسطة الذكاء الاصطناعي
- **الباحثون** — حسابات جماعية لأبحاث إحصائية
- **منصات المحتوى** — الخرائط الناطقة كإضافة لمنتج قائم

## السعر

الخريطة الناطقة (`/v1/chart`) — **20 اعتمادًا**. في الخطة المجانية (10,000 اعتماد/شهر) — 500 خريطة شهريًا مجانًا.

<CardGrid>
  <LinkCard title="البدء السريع →" href="/getting-started/" description="أول طلب في 5 دقائق" />
  <LinkCard title="مثال مفصل" href="/examples/natal/" description="المعلمات، الاستجابة، أنظمة البيوت" />
  <LinkCard title="الخطط" href="/pricing/" description="من مجاني إلى مؤسسة" />
</CardGrid>