FAQ answers

Γενικά

Τι είναι το AstroWay API;

Επαγγελματικό HTTP API για αστρολογικούς υπολογισμούς. 714 endpoints βασισμένα στο Swiss Ephemeris (WASM): γενέθλια χάρτη, synastry, προόδους, διευθύνσεις, μεταβάσεις, Human Design, αστροχαρτογραφία, rectification, AI ερμηνείες. Όλοι οι υπολογισμοί γίνονται στον διακομιστή — χωρίς εξαρτήσεις στη πλευρά του πελάτη.

Για ποιους προορίζεται αυτό το API;

Για προγραμματιστές που δημιουργούν αστρολογικές εφαρμογές (web/mobile), εταιρείες AI που προσθέτουν αστρολογικές λειτουργίες, επαγγελματίες αστρολόγους με scripts, καθώς και ερευνητές που χρειάζονται προγραμματιστική πρόσβαση στους υπολογισμούς.

Ποια είναι η ακρίβεια των υπολογισμών;

Το Swiss Ephemeris παρέχει ακρίβεια στις πλανητικές θέσεις έως ±1 δευτερόλεπτο τόξου, ενώ στους οίκους έως ±1 λεπτό τόξου. Τα αποτελέσματα έχουν επικυρωθεί έναντι του Astrodienst (Astro.com), Solar Fire, Zet 9 και Kepler. Υπο-δευτερόλεπτη απόκλιση έναντι των ephemerides της NASA JPL και του καταλόγου εκλείψεων NASA 5-Millennium.

Πώς συγκρίνεται το AstroWay με το Astro.com ή το Solar Fire;

Χρησιμοποιεί τον ίδιο κινητήρα Swiss Ephemeris — αυτόν που χρησιμοποιείται επίσης στο Solar Fire ($495 άδεια), Kepler ($995), Astro Gold ($29.99/μήνα) και Astrodienst (Astro.com). Έχει επικυρωθεί έναντι των ephemerides της NASA JPL και του επίσημου reference swetest από το Astrodienst. Υπο-δευτερόλεπτη απόκλιση (≤0.1″) στις πλανητικές θέσεις, ≤1 λεπτό στις εκλείψεις. Η διαφορά: το AstroWay είναι REST API έναντι μιας μηνιαίας συνδρομής από $5 αντί για μία εφάπαξ άδεια ή desktop GUI.

Ποιες συστήματα οίκων υποστηρίζονται;

15 συστήματα: Placidus (προεπιλογή), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC και Equal από MC. Μετάδωσε τον αντίστοιχο κωδικό στη παράμετρο houseSystem.

Πιστώσεις & Πληρωμές

Πώς λειτουργεί το σύστημα πιστώσεων;

Κάθε endpoint έχει σταθερή τιμή σε πιστώσεις (από 10 έως 500), ανάλογα με την πολυπλοκότητα του υπολογισμού. Ένας απλός lookup κοστίζει 10, ένας γενέθλιος χάρτης 20, ένα synastry 50, ενώ η rectification 500. Ο πλήρης πίνακας βρίσκεται στη σελίδα Τιμολόγηση.

Υπάρχει δωρεάν πρόγραμμα;

Ναι. Το πρόγραμμα Free παρέχει 10.000 πιστώσεις/μήνα, 10 αιτήματα/λεπτό. Δεν απαιτείται εισαγωγή κάρτας. Αρκεί για αξιολόγηση του προϊόντος και δημιουργία πρωτοτύπων.

Τι συμβαίνει όταν τελειώσουν οι πιστώσεις;

Στο πρόγραμμα Free, τα αιτήματα αποκλείονται μέχρι τον επόμενο μήνα (429 CREDITS_EXHAUSTED). Στα προγράμματα Indie/Starter/Pro/Business ενεργοποιείται η υπερχρέωση: $5 / $3 / $2 ανά 10.000 πρόσθετες πιστώσεις.

Κάνουν cache τα ίδια αιτήματα;

Ναι. Ένας ίδιος input εντός 5 λεπτών επιστρέφεται από το cache χωρίς χρέωση πιστώσεων. Επιβεβαιώνεται από την κεφαλίδα X-Cache: HIT.

Μπορώ να αγοράσω πιστώσεις χωρίς συνδρομή;

Όχι ακόμα. Η συνδρομή παρέχει προβλέψιμο προϋπολογισμό και καλύτερο όριο αιτημάτων. Ένα πρόγραμμα pay-as-you-go βρίσκεται υπό σχεδιασμό.

Τεχνικά

Ποιες SDK είναι διαθέσιμες;

• MCP server ✅ κυκλοφόρησε: npx -y @astroway/mcp — εκθέτει όλα τα 714+ endpoints ως εργαλεία για το Claude $1, Cursor, GPT και άλλους MCP-συμβατούς AI agents
• TypeScript SDK ✅ κυκλοφόρησε: npm install @astroway/sdk — types + autocomplete από OpenAPI 3.1, retry + idempotency, σφάλματα τύπου Stainless
• Python SDK ✅ κυκλοφόρησε: pip install astroway — sync Astroway + async AsyncAstroway, βασισμένο στο httpx, τυποποιημένο σύμφωνα με PEP 561
• PHP SDK ✅ κυκλοφόρησε: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, middleware για retry
• Go / Ruby / Rust 📋 προγραμματισμένο — εγγραφείτε για ειδοποίηση μέσω email στη σελίδα κάθε SDK (/sdk/<language>/)

Το API contract είναι REST + JSON, επομένως οποιοσδήποτε HTTP client λειτουργεί χωρίς SDK. Η συλλογή Postman και το OpenAPI 3.1 spec είναι δημόσια διαθέσιμα.

Υπάρχει mode sandbox;

Ναι. Τα κλειδιά aw_test_* δεν χρεώνουν πιστώσεις και επιστρέφουν τα ίδια αποτελέσματα. Ιδανικό για ανάπτυξη και testing.

Ποιο είναι το όριο αιτημάτων;

Εξαρτάται από το πρόγραμμα: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1.000 αιτήματα/λεπτό. Σε υπέρβαση, επιστρέφεται 429 με την κεφαλίδα Retry-After.

Υποστηρίζεται ο sideral ζώδιο;

Ναι. Μετάδωσε "zodiacType": "sidereal" και προαιρετικά "ayanamsaId" (προεπιλογή — Lahiri). Λειτουργεί με όλα τα endpoints.

Τι είναι τα endpoints του Human Design;

12 endpoints για τον υπολογισμό του Human Design: τύπος, στρατηγική, αρχή, προφίλ, ορισμός, σταυρός της ενσάρκωσης, κανάλια, κέντρα, Dream Rave, Hologenetic Profile, Penta (ομαδική δυναμική), χρονική ευαισθησία. Το πιο ολοκληρωμένο coverage του HD μεταξύ των εμπορικών APIs.

Ασφάλεια & Ιδιωτικότητα

Αποθηκεύονται δεδομένα των αιτημάτων;

Το API λειτουργεί stateless — δεδομένα όπως ημερομηνία/ώρα/συντεταγμένες γέννησης δεν αποθηκεύονται μετά την επεξεργασία του αιτήματος. Καταγράφονται μόνο μεταδεδομένα: key_id, endpoint, timestamp, latency, πιστώσεις. Καμία προσωπικά δεδομένα.

Το API συμμορφώνεται με το GDPR;

Ναι. Δεν αποθηκεύονται δεδομένα. Για χρήστες από την ΕΕ: καμία επεξεργασία PII, κανένα profiling, κανένα cookie. Το κλειδί API είναι συνδεδεμένο στον λογαριασμό σου, όχι στον τελικό χρήστη.

Είναι ασφαλείς οι AI ερμηνείες;

Τα AI endpoints (/interpret/*, /horoscope/*) διαθέτουν ενσωματωμένα safety guardrails: απαγόρευση ιατρικών, νομικών ή οικονομικών συμβουλών. Κάθε απάντηση περιλαμβάνει disclaimer. Πλήρες audit trail — για συμμόρφωση enterprise.

Υποστήριξη

Πώς μπορώ να λάβω βοήθεια;

Εξαρτάται από το πρόγραμμα: Free — κοινότητα, Indie — email (48 ώρες), Starter — email (24 ώρες), Pro — email (4 ώρες), Business — email + Slack (1 ώρα), Enterprise — αποκλειστικός manager στο Slack. Οι επαφές βρίσκονται στη σελίδα Επικοινωνία.

Υπάρχει SLA;

Indie: 99% uptime. Starter & Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: custom SLA με οικονομικές εγγυήσεις.