Εκκίνηση AstroWay API: πλήρης στοίβα αστρολογικών υπολογισμών με ακρίβεια Swiss Ephemeris

Σήμερα ανακοινώνουμε το AstroWay API — έναν υπολογιστικό backend για προγραμματιστές που δημιουργούν αστρολογικές εφαρμογές, προϊόντα ωροσκοπίων, λειτουργίες συμβατότητας για dating και AI agents που χρειάζονται να σκεφτούν χάρτες γεννήσεων.

Σε αυτό το άρθρο — τι πραγματικά κρύβεται μέσα στο API, ποιες ασυνήθιστες αποφάσεις πήραμε, τι αφήσαμε σκόπιμα εκτός και πώς καταλήξαμε εδώ. Χωρίς νερό.

🕓 Δημοσίευση από 2026-04-22, ενημερώθηκε 2026-05-09. Μερικά νούμερα είναι ξεπερασμένα. Τρέχουσα κατάσταση: 723 endpoints (αντί για 87 κατά την έναρξη), 818 CI snapshot tests (αντί για 183), ο MCP server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk βρίσκονται πλέον στους δημόσιους καταλόγους. Το πιο πρόσφατο status βρίσκεται στο /faq και στο changelog.

Ένα REST API βασισμένο στο Swiss Ephemeris (LGPL), μεταγλωττισμένο σε WASM και αναπτυγμένο ως υπηρεσία Node.js — τώρα με AI ερμηνείες ( цепочка failover GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) πάνω από πραγματικούς υπολογισμούς. Ο ίδιος κινητήρας που χρησιμοποιούν επαγγελματίες αστρολόγοι εδώ και 30+ χρόνια στο Solar Fire, Kepler, Astro Gold και Janus — ακρίβεια έως κλάσμα δευτερολέπτου, επικυρωμένη με την εφημερίδα NASA JPL και το επίσημο reference swetest από την Astrodienst (Astro.com).

Στοιχεία:

• 723 endpoints — δυτική ναталь αστρολογία, синаστρία, μεταβάσεις, προόδους, διευθύνσεις, επανόδου, αρμονικές, σταθερά αστέρια, αραβικά σημεία, αστροκαρτογραφία συν ένα πλήρες σύνολο Human Design
• 183 snapshot tests στο CI έναντι πραγματικής εξόδου από το swetest CGI και τον κατάλογο εκλείψεων της NASA — εκτελούνται σε κάθε PR
• p50 < 100 ms, p95 < 500 ms για τυπικούς υπολογιστικούς endpoints
• MCP server @astroway/mcp + τρία SDK στους δημόσιους καταλόγους: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — το ίδιο API σε τρεις γλώσσες
• MCP server: @astroway/mcp — παρέχει το API ως εργαλεία (tools) για τους Claude, GPT, Cursor και άλλους πράκτορες LLM
• Χρεώσεις βάσει credits: δωρεάν πλάνο (10.000 credits/μήνα, χωρίς κάρτα), επί πληρωμή — από $5/μήνα

Πλήρης τεκμηρίωση: api.astroway.info/docs/api/. Ζωντανή κατάσταση: api.astroway.info/status.

Πριν τρία χρόνια ξεκινήσαμε να χτίζουμε καταναλωτικές αστρολογικές εφαρμογές. Το υπολογιστικό layer αποδείχθηκε το πιο δύσκολο μέρος — πολύ πιο περίπλοκο από το UI ή το περιεχόμενο. Οι υπάρχοντες серβις είτε:

1. Είχαν επιφανειακή κάλυψη (10–30 endpoints, κυρίως μόνο natal)
2. Ήταν ακριβοί σε κλίμακα ($0.02–$0.10 ανά αίτημα χωρίς χονδρικές εκπτώσεις)
3. Χρησιμοποιούσαν κλειστούς κινητήρες των οποίων την ακρίβεια δεν μπορούσες να επαληθεύσεις
4. Εστίαζαν στη βεδική αστρολογία, ενώ η δυτική παρουσιαζόταν ως δευτερεύουσα

Έτσι, αυτοσχεδιάσαμε το Swiss Ephemeris μόνοι μας και γράψαμε το δικό μας υπολογιστικό layer — αρχικά για την καταναλωτική μας εφαρμογή app.astroway.info, μετά για την ιστοσελίδα μάρκετινγκ astroway.info, η οποία παράγει ημερήσια ωροσκόπια εκατοντάδων χιλιάδων επισκεπτών κάθε μήνα.

Μετά από τρία χρόνια παραγωγικής χρήσης αυτού του κώδικα, καταλήξαμε σε δύο συμπεράσματα:

1. Ο ίδιος υπολογιστικός κινητήρας πρέπει να είναι προσβάσιμος και σε άλλους προγραμματιστές — όχι επειδή δεν μπορούν να τον γράψουν μόνοι τους, αλλά επειδή το βιβλιοθήκη + WASM + caching + CI για ακρίβεια είναι μισό χρόνο δουλειάς που κανείς δεν πρέπει να επανεφεύρει.
2. Η κάλυψή μας στο Human Design (12 endpoints — χάρτης, τύπος, αρχή, προφίλ, πύλες, κανάλια, περιγράμματα, πλανητικές ενεργοποιήσεις, σταυρός ενσάρκωσης, definition) είναι πραγματικά μοναδική. Κανένας ανταγωνιστής δεν προσφέρει πλήρες Human Design μέσω API.

Αυτή είναι η κυκλοφορία.

Έχουμε /nakshatras, /ashtakavarga και endpoints για divisional χάρτες, αλλά δεν υπάρχουν Dasha, Panchang, Ashtakoota, KP. Ο λόγος: στη βεδική αστρολογία υπάρχουν α unresolved διαφορές μεταξύ σχολών (πόλεμοι αγιάμσα, διαφωνίες για κούσπηδες KP, επιλογή σχολής dash). Ένα βιαστικά φτιαγμένο βεδικό τμήμα έναντι των Prokerala και VedicAstroAPI θα είχε μόνο κριτική.

Η απόφαση είναι σαφής: το βεδικό τμήμα είναι ξεχωριστή φάση 3, μετά την σταθεροποίηση της ζήτησης στη δυτική αστρολογία και τον χρόνο επικύρωσης έναντι του Jagannatha Hora και του Parashara’s Light. Καλύτερα να μην κυκλοφορήσουμε καθόλου παρά να κυκλοφορήσουμε κάτι κακό.

Ένα αίτημα /chart κοστίζει περίπου 50 φορές λιγότερους υπολογισμούς από ένα 365-ημέρου /forecast-calendar. Μια flat τιμή ανά αίτημα είτε θα απέκλειε τους ελαφρούς χρήστες είτε θα επιδοτούσε τους βαρείς. Τα credits αντιστοιχούν το κόστος στην πραγματική εργασία — δες τον πίνακα ανά endpoint στη σελίδα τιμολόγησης.

Οι απαντήσεις στο δωρεάν πλάνο περιλαμβάνουν ένα πεδίο _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api — get your own key at api.astroway.info"
}

Δεν μας κοστίζει τίποτα, αλλά δίνει στους δωρεάν χρήστες έναν μικρό λόγο να αναβαθμίσουν. Στο πλάνο Hobby+ αφαιρείται στις ρυθμίσεις του κλειδιού. Δανειστήκαμε αυτό το pattern από τους Zapier και RevenueCat.

Το /rectification (εύρεση χρόνου γέννησης βάσει γεγονότων μέσω grid πιθανοτήτων) είναι υπολογιστικά ακριβό: ένα αίτημα διαρκεί 10–60 δευτερόλεπτα και κάνει δεκάδες χιλιάδες ενδιάμεσους υπολογισμούς Swiss Ephemeris. Το περιορίσαμε στο πλάνο Pro ($59/μήνα) και βάλαμε μεγάλη τιμή credits, επειδή η κατάχρηση θα κατέστρεφε την κοινή υποδομή για όλους τους υπόλοιπους.

Τα endpoints /interpret/* δρομολογούνται μέσω της ιδιωτικής μας πύλης AI, η οποία βρίσκεται πάνω από τις κορυφαίες models της αγοράς (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) με αυτόματο failover. Δεν σε κλειδώνουμε στους δικούς μας prompts — κάθε απάντηση με ερμηνεία περιλαμβάνει τις αρχικές υπολογισμούς, έτσι μπορείς να τις ξαναχρησιμοποιήσεις με το δικό σου LLM, αν η δική μας φωνή δεν σου αρέσει. Τα πλήρη prompts και outputs καταγράφουμε σε έναν πίνακα audit για συμμόρφωση B2B (αποθήκευση 90 ημερών).

• Βεδικό τμήμα — φάση 3, μετά τις πρώτες επιβεβαιώσεις ζήτησης (δες παραπάνω)
• Webhooks για thresholds — υλοποιημένα, αλλά το UI είναι ακατέργαστο· βελτιώνουμε
• Δημόσια widgets (<script src="api.astroway.info/widget/natal.js">) — φάση 7
• Πρόσθετο για την κύρια ιστοσελίδα μάρκετινγκ — ξεχωριστό project, σχεδιάζεται στο πλαίσιο της οικοσυστήματος astroway.info

1. Διάβασε την τεκμηρίωση αν θες να καταλάβεις το «γιατί»: api.astroway.info/overview
2. Γρήγορο ξεκίνημα σε 5 λεπτά με κώδικα: Astrology API Quick Start
3. Τιμολόγηση, συμπεριλαμβανομένου του πίνακα credits ανά endpoint: api.astroway.info/pricing
4. Εγγραφή — δωρεάν, χωρίς κάρτα: api.astroway.info/dashboard/sign-up

Αν φτιάξεις κάτι πάνω στο API — είτε βρεις ένα bug είτε θες ένα endpoint που δεν έχουμε ακόμα — γράψε μας. Προτιμούμε να ακούσουμε εκατό προγραμματιστές που ζητούν κάτι παρά να κυκλοφορήσουμε features που κανείς δε χρησιμοποιεί.

Ερωτήσεις, αιτήματα, περίεργα edge cases: hello@astroway.info.

Το roadmap είναι δημόσιο — PRODUCT-PLAN.md — τι έχει ολοκληρωθεί, τι ακολουθεί και τι αναβάλλεται και γιατί.

Καλώς ορίσατε.