# Εφαρμογές αστρολογίας

Χτίζεις μια εφαρμογή astro παρόμοια με τις Co-Star, Sanctuary, The Pattern, Chani ή Costar Compat; Το AstroWay API αντικαθιστά την ανάγκη για αδειοδότηση του Solar Fire ($495) ή συγγραφή του δικού σου κώδικα για τις εφημερίδες: {siteMeta.endpoints} endpoints (ωροσκόπια, σύναστρη, διαβάσεις, Human Design, ερμηνείες AI), OpenAPI 3.1 για τη δημιουργία τυποποιημένων πελατών (TS / Python SDK στο roadmap), ακρίβεια Swiss Ephemeris — η ίδια μηχανή που χρησιμοποιείται στο Astrodienst και το Kepler.

## Τυπική αρχιτεκτονική

```
Χρήστης (περιηγητής / κινητό)
     ↓
Το δικό σου backend (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Απάντηση JSON → απόδοση στο δικό σου UI
```

<Aside type="caution">
Ποτέ μην τοποθετείς κλειδί API στον frontend κώδικα. Οι κλήσεις στο AstroWay API πρέπει να πραγματοποιούνται μέσω του δικού σου backend ή λειτουργιών διακομιστή (δρόμοι API Next.js, λειτουργίες Vercel, AWS Lambda).
</Aside>

## Βασικά endpoints για αστρο-εφαρμογές

### MVP (ελάχιστο βιώσιμο προϊόν)

| Endpoint | Πιστώσεις | Για τι |
|---|---|---|
| `/v1/chart` | 20 | Δημιουργία ωροσκοπίου |
| `/v1/synastry` | 50 | Συμβατότητα δύο ατόμων |
| `/v1/horoscope/daily` | 20 | Καθημερινό горόσκοπιο |

Τρία endpoints — και έχεις ήδη μια λειτουργική εφαρμογή με ωροσκόπιο, συμβατότητα και καθημερινό περιεχόμενο.

### Επεκταμένο προϊόν

| Endpoint | Πιστώσεις | Για τι |
|---|---|---|
| `/v1/transits` | 50 | Τρέχουσες διαβάσεις στο ωροσκόπιο |
| `/v1/solar-return` | 50 | Ηλιακή επιστροφή (ετήσιο ωροσκόπιο) |
| `/v1/progressions` | 50 | Δευτερεύουσες προόδους |
| `/v1/interpret/natal` | 50 | Ερμηνεία AI του ωροσκοπίου |
| `/v1/transit-calendar` | 100 | Ημερολόγιο γεγονότων διαβάσεων |
| `/v1/human-design` | 50 | Χάρτης Human Design |

### Προνομιακές λειτουργίες

| Endpoint | Πιστώσεις | Για τι |
|---|---|---|
| `/v1/rectification` | 500 | Διόρθωση ώρας γέννησης |
| `/v1/acg` | 50 | Αστροκαρτογραφία (πού είναι καλύτερα να ζήσεις) |
| `/v1/forecast-calendar` | 100 | Ετήσια πρόβλεψη-heatmap |
| `/v1/group-synastry` | 100 | Ομαδική συμβατότητα |

## Υπολογισμός προϋπολογισμού

### Σενάριο: 100 DAU (ημερήσιοι ενεργούς χρήστες)

Υποθέτουμε ότι ο μέσος χρήστης κάνει 3 ενέργειες την ημέρα:

| Ενέργεια | Endpoint | Πιστώσεις | Αιτήματα/ημέρα | Πιστώσεις/ημέρα |
|---|---|---|---|---|
| Προβολή ωροσκοπίου | `/v1/chart` | 20 | 100 | 2.000 |
| Καθημερινό горόσκοπιο | `/v1/horoscope/daily` | 20 | 100 | 2.000 |
| Συμβατότητα | `/v1/synastry` | 50 | 30 | 1.500 |
| **Σύνολο** | | | **230** | **5.500/ημέρα** |

**~165.000 πιστώσεις/μήνα** (5.500 × 30) → τιμολόγιο **Starter ($19/μήνα, 200.000 πιστώσεις)** με περιθώριο 21%, ή **Indie ($5/μήνα, 50.000 πιστώσεις)** με χρέωση overage ~$5 για τις επιπλέον 110K πιστώσεις.

### Σενάριο: MVP με 20 DAU

| Ενέργεια | Πιστώσεις/ημέρα |
|---|---|
| 20 ωροσκόπια | 400 |
| 20 горόσκοπια | 400 |
| 5 συμβατότητες | 250 |
| **Σύνολο** | **1.050/ημέρα** |

**~31.500 πιστώσεις/μήνα** → τιμολόγιο **Indie ($5/μήνα, 50.000 πιστώσεις)**.

## Συμβουλές

- **Κάνε cache τα ωροσκόπια** — η είσοδος είναι αμετάβλητη (η ημερομηνία γέννησης δεν αλλάζει), επομένως το αποτέλεσμα μπορεί να κάνει cache για πάντα στη βάση σου
- **Κάνε cache τα горόσκοπια ανά ημέρα** — το καθημερινό горόσκοπιο είναι το ίδιο για όλους τους ανθρώπους του ίδιου ζώδιου, δημιούργησε μία φορά και μοίρασέ το
- **Κλειδιά sandbox** (`aw_test_*`) — για ανάπτυξη, δεν καταναλώνουν πιστώσεις
- **Codegen από OpenAPI 3.1** — πέταξε το `/v1/openapi.json` στο `openapi-typescript` ή `openapi-python-client` και πήγαινε τυποποιημένο πελάτη (έτοιμα SDK στο roadmap)

<CardGrid>
  <LinkCard title="Γρήγορη εκκίνηση →" href="/getting-started/" description="Πρώτη αίτηση σε 5 λεπτά" />
  <LinkCard title="Birth Chart API" href="/products/birth-chart-api/" description="Λεπτομέρειες για το ωροσκόπιο γέννησης" />
  <LinkCard title="Τιμολόγηση" href="/pricing/" description="Από δωρεάν έως Enterprise" />
</CardGrid>