# API Vedic

Το AstroWay API διαθέτει **354+ τελικά σημεία βεδικής αστρολογίας** — την πιο ολοκληρωμένη κάλυψη Jyotish μεταξύ εμπορικών API. Κλασική BṚHAT PARĀŚARA HORĀ ŚĀSTRA, πλήρης Lal Kitab, μέθοδος KP, Jaimini Sūtras — όλα έχουν διασταυρωθεί με το PyJHora.

## Τι υπολογίζεται

| Κατηγορία | Κάλυψη |
|---|---|
| **Δάσα** | 10 συστήματα (Vimśottarī + 9 εναλλακτικά) × 5 επίπεδα = **50 τελικά σημεία** |
| **Βάργκα** | Shodasha varga D1–D60 σε μία κλήση |
| **Παντσάνγκα** | Τίθι, Καρανά, Γιόγκα-ημέρας, Νάξτρα-ημέρας, Τσόγκαδία, Χορά, Ράχου-καάλ, πλήρης |
| **Σάντμπαλα** | 6-πλευρή δύναμη: Σθάνα + Ντικ + Κάλα + Τσέστα + Νάισαργκικα + Ντρικ + πλήρης |
| **Γιόγκα** | Παράσαρά (Ράτζα, Ντάνα, Ντάρμα-Καρμάντιπάτι, Παντσά-Μαχαπούρουσα, Γκαντζάκισάρι, Άντι) + Τζαϊμίνι (καράκα-γιόγκα, καρακάμσα, σούμπχα-γκράχα) |
| **Ντόσα** | Παράσαρά (Μάνγκαλα, Κάαλ-Σάρπ, Πίτρου, Σράπιτ, Γκράχαν, Γκουρού-Τσαντάλ) + Lal Kitab Μάγκλικ + KP |
| **Συμβατότητα** | Αστάκουτ (8-πλευρή Γκουν-Μίλαν), Ντάσακούτα, Μάγκλικ-τσέκ, Μάγκλικ-μέτς, Μπρίγκου-μέτς |
| **Μουχούρτα** | Εκλογική — γάμος, αυτοκίνητο, επιχείρηση, ταξίδι, βάπτιση, επέμβαση, εκπαίδευση, επενδύσεις, ακίνητα, γκρίχα-πράβες, αρραβώνες, δικαστική διαδικασία |
| **Lal Kitab** | Πλήρες πακέτο: χάρτης, γράχες, ρήσι, τάτβας, βάργκας, ουπάγια |
| **KP** | Krishnamurti Paddhati με ruling planets, sub-lord theory, KP yogas/doshas |
| **Jaimini** | Καράκι, Τσαρά-καράκι, Πάδας, Ουπαπάδα, Αспекτοί, Ντρίστι, Άτμακαράκα-Νάβαμσα, Ντάχα-σούμαρυ, Γιόγκα + extras: καράκα-γιόγκα, καρακάμσα, άτμακαράκα-ρότε이션, argala-analysis |

## Παράδειγμα: Βιμσότταρι-ντάσα

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "tzOffset": "+03:00",
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/vedic/dashas/vimshottari/maha', {
      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',
        tzOffset: '+03:00',
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data } = await r.json();
    console.log(`Τρέχουσα MD: ${data.current.lord} έως ${data.current.endDate}`);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/vedic/dashas/vimshottari/maha',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'tzOffset': '+03:00',
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
    )
    data = r.json()['data']
    print(f"Current MD: {data['current']['lord']} until {data['current']['endDate']}")
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('vedic/dashas/vimshottari/maha', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'tzOffset' => '+03:00',
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $data = json_decode($r->getBody(), true)['data'];
    echo "Current MD: {$data['current']['lord']} until {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Μοναδικές δυνατότητες

Τελικά σημεία που δεν υπάρχουν στους ανταγωνιστές:

- **10 συστήματα ντάσα** συμπεριλαμβανομένων σπάνιων Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola (οι περισσότερες API έχουν μόνο Vimśottarī)
- **Καράκαμσα ως χάρτης 12 σπιτιών** — πλήρης προβολή με ιστά-ντεβάτα + τιμές moksha
- **Argala-analysis** — πλήρης σάρωση Argala + Virodhargala ανά 12 σπίτια με δείκτη netInfluence
- **Atmakaraka-rotation** — προοδευτική ΑΚ μέσα από τη ζωή με triggers γεγονότων
- **Cross-school doshas** — Παράσαρά + Lal Kitab + KP σε μία κλήση (οι περισσότερες δίνουν μόνο ένα σχολείο)

## Ποιοι το χρησιμοποιούν

- **Εφαρμογές Ινδικής αστρολογίας** (Pratyangira, Drik Panchang, AstroSage ανάλογα) — πλήρης backend χωρίς ανάγκη δικής σου εφημερίδας
- **Συμβατότητα γάμου** — Αστάκουτ + Ντάσακούτα + Μάγκλικ σε μία κλήση
- **Εφαρμογές ωροσκοπίου κινητού** — καθημερινό Παντσάνγκα μέσω `/v1/vedic/panchang/full` (8 στοιχεία σε 1 αίτημα)
- **Υπηρεσίες εκλογικής αστρολογίας** (βάπτιση παιδιού, μουχούρτα γάμου) — `/v1/vedic/muhurat/*` 12 είδη γεγονότων
- **Υπηρεσίες βεδικής συμβατότητας** — πλήρης έκθεση μέσω `/v1/vedic/compatibility/full`

## Ακρίβεια

Όλοι οι υπολογισμοί βασίζονται στο **Swiss Ephemeris** (υπο-δευτερόλεπτη ακρίβεια) + διασταυρωμένα με **PyJHora** (de-facto reference υλοποίηση σε Python). Οι διαφορές, όπου υπάρχουν, τεκμηριώνονται στο `docs/AUDIT-TRAIL.md`.

Τα σχολεία διαφορετικών παραδόσεων (Lal Kitab, KP, Jaimini) έχουν ξεχωριστές **ΚΙΤΡΙΝΕΣ** επισήμανση για τελικά σημεία όπου χρησιμοποιείται η μέθοδος ενός μόνο συγγραφέα (Lal Kitab — μόνο Pt. Roop Chand Joshi) — ο integrator βλέπει το επίπεδο κανονικότητας.

## Τοπικοποίηση

Οι βεδικές εκθέσεις είναι διαθέσιμες σε **20 γλώσσες** (T0 χειροκίνητα, T1 AI Beta — δες [`/languages/`](/languages/)). Μετάδωσε `lang=<code>` σε οποιοδήποτε τελικό σημείο `/v1/reports/*`.

## Κόστος

Τα περισσότερα βεδικά τελικά σημεία είναι **Επίπεδο 2 (20 πιστώσεις)**. Μεγάλες εκθέσεις (πλήρης συμβατότητα, σαρωτής μουχούρτα) — Επίπεδο 3 (50 πιστώσεις). Εκθέσεις PDF Lal Kitab / Vedic Kundli — Επίπεδο 7 (5000 πιστώσεις).

Στο δωρεάν σχέδιο — **500 βεδικές κλήσεις το μήνα δωρεάν**.

<CardGrid>
  <LinkCard title="Κατηγορίες τελικών σημείων →" href="/vedic/" description="Ντάσα, Βάργκα, Παντσάνγκα, Σάντμπαλα, Γιόγκα, Ντόσα, Συμβατότητα, Μουχούρτα" />
  <LinkCard title="Γρήγορη εκκίνηση" href="/getting-started/" description="Πρώτη κλήση σε 5 λεπτά" />
  <LinkCard title="Τιμολόγηση" href="/pricing/" description="Από δωρεάν έως Enterprise" />
  <LinkCard title="Υποστήριξη γλωσσών" href="/languages/" description="20 γλώσσες — βεδικές εκθέσεις" />
</CardGrid>