# Επισκόπηση

**AstroWay API** — είναι ένας επαγγελματικός backend για αστρολογικούς υπολογισμούς ως υπηρεσία.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} εндπόντων με βάση το Swiss Ephemeris (WASM), με κάλυψη τεχνικών που δεν υπάρχουν σε κανέναν ανταγωνιστή: αρμονικές, δρακονικές χάρτες, CCG, τομείς του Gauquelin, πλήρες Human Design, ρητορική.

## Για ποιόν είναι

1. **Αναπτυξιακοί αστρολογικών εφαρμογών** (web, mobile), που χρειάζονται ακριβείς και ποικίλους υπολογισμούς χωρίς δική τους υπολογιστική υποδομή.
2. **Εταιρείες AI**, που ενσωματώνουν αστρολογικές λειτουργίες — υπάρχει εγγενής MCP-διακομιστής για το Claude, το ChatGPT και άλλα πράγματα.
3. **Επαγγελματίες αστρολόγοι**, που κατασκευάζουν δικά τους εργαλεία ή σενάρια για πελάτες.
4. **Ερευνητές**, που χρειάζονται προγραμματική πρόσβαση σε υπολογισμούς για στατιστικές έρευνες.
5. **Πλατφόρμες περιεχομένου**, που προσθέτουν αστρολογικές λειτουργίες στο υπάρχον προϊόν.

## Για ποιόν δεν είναι

- Γνωστοί widget «καρκίνος σήμερα» χωρίς έλεγχο — οι ερμηνείες AI και οι ωροσκόποι υπάρχουν (`/interpret/*`, `/horoscope/*`), αλλά σχεδιάστηκαν ως API για αναπτυξιακούς, όχι ως έτοιμο widget.
- Βεδική αστρολογία ως основική εξειδίκευση — για Vedic-first projects (Dasha συστήματα, Panchang, KP) Prokerala και VedicAstroAPI είναι ισχυρότεροι. Για δυτική αστρολογία + Human Design + σπάνιες τεχνικές (ρητορική, αρμονικές, CCG) AstroWay — κερδίζει. Δείτε /compare/.
- Ταρό/αριθμολογία — μόνο αστρολογία και Human Design. I-Ching υπάρχει ως бонουσ εндπόντων.

## Τι κάνει το AstroWay μοναδικό

### 1. Σπάνιες τεχνικές σε μορφή API

| Τεχνηκή | Γιατί |
|---|---|
| **Αρμονικές χάρτες** (H2–H180) | Ερευνητική αστρολογία (μέθοδος του Τζον Άντεϊ) |
| **Δρακονική χάρτα** | Καρμική/ψυχική αστρολογία |
| **CCG (Cyclo-Carto-Graphy)** | Προηγμένη αστρο-χαρτογραφία — premium τεχνική του Τζιμ Λιούις |
| **Τομείς του Gauquelin** | Στατιστική αστρολογία, ακαδημαϊκή χρήση |
| **Τριτογενείς προοδώσεις** | Τρίτος τύπος προοδών — νιχέ, αλλά εκτιμώμενη |
| **Αντισίες / αντί-αντισίες** | Κλασική ελληνο-ρωμαϊκή τεχνική — αναβίωση παραδοσιακών σχολών |
| **Παράλληλοι ασPECTS** | ΑσPECTS με βάση τη δεκαλιναία — προηγμένες πρακτικές |
| **Ρητορική μέσω API** | Διόρθωση ώρας γέννησης — υψηλή αξία |
| **Πλανητικοί κύκλοι** (συνδέσεις) | Μουντάιν αστρολογία — παγκόσμια γεγονότα |
| **Κυκλικός δείκτης Barbo** | Μουντάιν αστρολογία |
| **Ελάχιστο Algo** | Χρόνοι ακίνητων αστέρων — εκλεκτική αστρολογία |
| **Γραμμές τοπικού χώρου** | Φενγκ σούι-στυλ οδηγία αστρολογίας |
| **Συνδέσεις διαθέσεων** | Γραφικές διαθέσεις — κλασική τεχνική |
| **Αλμουτέν figuris** | Μεσαιωνική τεχνική — παραδοσιακή αναβίωση |

### 2. Ακρίβεια Swiss Ephemeris — το ίδιο κινητήριο που στο Solar Fire ($495), Kepler ($995), Astro Gold

Το ίδιο Swiss Ephemeris (LGPL), που χρησιμοποιούν οι επαγγελματίες αστρολόγοι στο Solar Fire, Kepler, Astro Gold και Janus уже 30+ χρόνια — μόνο σε WASM-συναρμολόγηση και ως REST API, χωρίς μεσάζοντα. Ακρίβεια:

- Πλανητικές θέσεις: ±1 γωνιακή δευτερόλεπτο vs NASA JPL ephemeris
- Κούσπιδες οίκων: ±1 γωνιακή λεπτό
- Επαλήθευση ενάντια στο Zet 9, Solar Fire (ιδιόκτητο ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — αποκλίσεις εντός του ορίου του λάθους της μεθόδου (≤0.1″).

### 3. {siteMeta.endpoints} εндπόντων — βαθύ κάλυμμα δυτικών τεχνικών

{siteMeta.westernCount} υπολογιστικών εντπόντων δυτικής αστρολογίας (4 σχολές Hellenistic, modern psychological, evolutionary, cosmobiology) + ερμηνείες AI + πλήρες Human Design. Βάθος αντί για διάχυση σε δεκάδες κατευθύνσεις.

## Αρχιτεκτονική

```
Η εφαρμογή σας
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Υπολογισμός και επιστροφή JSON
```

- Οι υπολογισμοί εκτελούνται **στο διακομιστή** — δεν υπάρχουν WASM-μπλομπ στο frontend της εφαρμογής σας, δεν υπάρχουν ερωτήσεις αδειών Swiss Ephemeris.
- Η κατάσταση στο διακομιστή δεν αποθηκεύεται — κάθε αίτηση είναι αυτοτελής. Δεν υπάρχει διαρροή δεδομένων για τους πελάτες.
- Οι κλειδιά API είναι συνδεδεμένα με το σχέδιο, το όριο ταχύτητας και το ημερήσιο ισοζύγιο πιστώσεων. Παρακολούθηση μέσω dashboard.

## Επόμενο

- [Γρήγορη έναρξη](/getting-started/) — η πρώτη αίτηση σε 5 λεπτά
- [Αυθεντικοποίηση](/authentication/) — πώς να λάβετε και να αποθηκεύσετε το κλειδί
- [Πιστώσεις και όρια](/rate-limits-credits/) — πώς λειτουργεί η χρέωση
- [Τεκμηρίωση API](/docs/api/) — όλα τα εντπόντια με διαδραστικό playground