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

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

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

🕓 Καταχώρηση από 2026-04-22, ενημερώθηκε 2026-05-09. Ορισμένοι αριθμοί είναι ξεπερασμένοι. Τρέχουσα κατάσταση: 865 endpoints (και όχι 87 κατά την κυκλοφορία), 888 CI snapshot-tests (και όχι 183), ο MCP-server @astroway/mcp + το TypeScript SDK @astroway/sdk + το Python SDK astroway + το PHP SDK astroway/sdk είναι πλέον όλα διαθέσιμα σε public registries. Η πιο πρόσφατη κατάσταση - στο /faq και στο changelog.

REST API βασισμένο στο Swiss Ephemeris - τώρα και με AI-ερμηνείες πάνω από πραγματικούς υπολογισμούς. Ο ίδιος κινητήρας που χρησιμοποιούν οι επαγγελματίες αστρολόγοι για 30+ χρόνια στα Solar Fire, Kepler, Astro Gold και Janus - ακρίβεια μέχρι κλάσματος δευτερολέπτου τόξου, επαληθευμένη με την εφημερίδα NASA JPL και την επίσημη αναφορά swetest από την Astrodienst (Astro.com).

Αριθμοί:

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

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

Πριν από τρία χρόνια αρχίσαμε να δημιουργούμε καταναλωτικές αστρολογικές εφαρμογές. Το υπολογιστικό επίπεδο αποδείχθηκε το πιο περίπλοκο μέρος - πολύ πιο περίπλοκο από το UI ή το περιεχόμενο. Οι υπάρχουσες υπηρεσίες είτε:

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

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

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

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

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

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

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

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

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

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

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

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

Τα endpoints /interpret/* λειτουργούν μέσω του ιδιωτικού μας AI-gateway με αυτόματο failover μεταξύ πολλών μοντέλων. Δεν σε κλειδώνουμε στα δικά μας prompts - κάθε απάντηση με ερμηνεία περιέχει τους αρχικούς υπολογισμούς, οπότε μπορείς να χρησιμοποιήσεις το δικό σου LLM, αν η δική μας φωνή δεν σου ταιριάζει. Τα πλήρη prompts και οι έξοδοι καταγράφονται σε έναν πίνακα ελέγχου για B2B-συμμόρφωση (αποθήκευση 90 ημερών).

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

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

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

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

Ο Roadmap είναι δημόσιος - PRODUCT-PLAN.md - τι έχει γίνει, τι ακολουθεί, τι έχει αναβληθεί και γιατί.

Καλώς ήρθες.