# जन्म कुंडली API

जन्म कुंडली किसी भी ज्योतिषीय एप्लिकेशन (Co-Star, Sanctuary, The Pattern, Chani — सभी इसी पर आधारित हैं) की नींव होती है। AstroWay API एक ही कॉल में कुंडली बनाने और उसका विश्लेषण करने के लिए पूर्ण सेट एंडपॉइंट प्रदान करता है: बेसिक ग्रह स्थितियों से लेकर उसी Swiss Ephemeris तक, जो Solar Fire और Astrodienst में उपयोग होती है, और दुर्लभ तकनीकों तक जो प्रतिस्पर्धियों में उपलब्ध नहीं हैं — कुल 700+ प्लेटफॉर्म एंडपॉइंट्स में से।

## क्या गणना की जाती है

पूर्ण जन्म कुंडली में **ज्योतिष त्रयी** शामिल होती है — व्यक्तित्व के तीन "चेहरे", जिन्हें उपयोगकर्ता बार-बार अध्ययन करते रहते हैं (इससे उपयोगकर्ता प्रतिधारण बढ़ता है):

- **ग्रह स्थितियां** — सूर्य (पहचान/उद्देश्य), चंद्रमा (भावनात्मक कोर/आवश्यकताएं), बुध, शुक्र, मंगल, बृहस्पति, शनि, यूरेनस, नेपच्यून, प्लूटो + उत्तरी नोड, चिरोन। देशांतर, अक्षांश, गति, राशि, भाव, प्रतिगामी स्थिति।
- **भाव कुस्पिड्स** — 15 प्रणालियों में से चुनाव (प्लेसिडस, कोच, पूर्ण राशि, समान, और अन्य)। एएससी (जैसे दूसरों द्वारा देखा जाने वाला उपयोगकर्ता), एमसी (करियर/सार्वजनिक छवि), वर्टेक्स।
- **एस्पेक्ट्स** — संयोग, विपक्ष, त्रिकोण, वर्ग, षट्कोण, क्विनकनक्स। ऑर्ब, लागू/अलग होना।
- **कुंडली सेक्टा** — दिवस/रात्रि (क्रिस ब्रेनन / डेमेट्रा जॉर्ज शैली में शास्त्रीय हेलनिस्टिक ज्योतिष के लिए)।

## एंडपॉइंट्स

| एंडपॉइंट | क्रेडिट्स | क्या लौटाता है |
|---|---|---|
| `/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 | पारस्परिक रिसेप्शन्स |

## उदाहरण

<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>

## कौन उपयोग करता है

- **ज्योतिषीय एप्लिकेशन** — वेब और मोबाइल एप्लिकेशन जिनमें कुंडली निर्माण शामिल है
- **AI एजेंट्स** — AI व्याख्याओं के लिए 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>