FAQ answers

Γενικά

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

Ένα επαγγελματικό HTTP API για αστρολογικούς υπολογισμούς. 771 endpoint βασισμένο στο Swiss Ephemeris: γενέθλια χάρτες, συνάστρα, προόδους, διευθύνσεις, μεταβάσεις, Human Design, αστροκαρτογραφία, διόρθωση, AI-ερμηνείες. Όλοι οι υπολογισμοί γίνονται στον διακομιστή - χωρίς εξαρτήσεις στην πλευρά του πελάτη.

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

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

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

Το Swiss Ephemeris παρέχει ακρίβεια θέσεων πλανητών έως ±1 γωνιακό δευτερόλεπτο, cusp οίκων έως ±1 γωνιακό λεπτό. Τα αποτελέσματα επαληθεύονται έναντι του Astrodienst (Astro.com), Solar Fire, Zet 9 και Kepler. Sub-arcsecond drift σε σχέση με το NASA JPL ephemeris και το NASA 5-Millennium Eclipse Catalog.

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

Ίδιος κινητήρας Swiss Ephemeris - ο ίδιος που χρησιμοποιείται στο Solar Fire ($495 άδεια), Kepler ($995), Astro Gold ($29.99/μήνα) και Astrodienst (Astro.com). Επικυρώθηκε έναντι του NASA JPL ephemeris και της επίσημης αναφοράς swetest από το Astrodienst. Sub-arcsecond drift (≤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, συνάστρα - 50, διόρθωση - 500. Πλήρης πίνακας στη σελίδα Τιμές.

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

Ναι. Το Free πρόγραμμα δίνει 10 000 κρέντιτ/μήνα, 10 req/min. Χωρίς εισαγωγή κάρτας. Αρκετό για αξιολόγηση του προϊόντος και πρωτοτυποποίηση.

Τι συμβαίνει όταν εξαντληθούν τα κρέντιτ;

Στο Free - τα αιτήματα μπλοκάρονται μέχρι τον επόμενο μήνα (429 CREDITS_EXHAUSTED). Στα Indie/Starter/Pro/Business - ενεργοποιείται overage: $5 / $3 / $2 ανά 10 000 επιπλέον κρέντιτ.

Κρύβονται (cache) τα ίδια αιτήματα;

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

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

Όχι, προς το παρόν. Η συνδρομή δίνει προβλέψιμο προϋπολογισμό και καλύτερο rate limit. Pay-as-you-go προγραμματίζεται.

Τεχνικά

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

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

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

Υπάρχει sandbox‑mode;

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

Ποιο είναι το rate limit;

Εξαρτάται από το πρόγραμμα: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1 000 req/min. Σε υπέρβαση - 429 με header Retry-After.

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

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

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

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

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

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

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

Συμμορφώνεται το API με τις απαιτήσεις GDPR;

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

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

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

Υποστήριξη

Πώς να λάβεις βοήθεια;

Εξαρτάται από το πρόγραμμα: Free - community, 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: προσαρμοσμένο SLA με οικονομικές εγγυήσεις.

Παρόμοια ονόματα

Σχετίζεται το AstroWay API (astroway.info) με τη συνδρομή “Astroway” από το astroway.life;

Όχι. astroway.info και api.astroway.info - είναι ξεχωριστή, ανεξάρτητη εταιρεία. Παρέχουμε αστρολογικό API για προγραμματιστές (api.astroway.info), εφαρμογή για τελικούς χρήστες (app.astroway.info) και συμβουλές αστρολόγου. Δεν έχουμε καμία σχέση με τη καταναλωτική αστρολογική συνδρομή που προωθείται και χρεώνεται ως “Astroway” μέσω astroway.life (emails από no-reply@astroway.life, πρόσωπο “Celeste”, στην τραπεζική δήλωση - “Astroway”). Ο διαχειριστής αυτής της συνδρομής είναι TrafficLeader OÜ (Εσθονία, επίσης traffic-leader.com); ο συνδεδεμένος biller SKYREAD.PRO είναι ABCMobile OÜ (Εσθονία). Μόνο η ονομασία ακούγεται παρόμοια - είναι διαφορετικές εταιρείες.

Μου χρεώνουν “Astroway” - πώς να ακυρώσω τη συνδρομή και να πάρω επιστροφή;

Αν χρεώνονται για τη συνδρομή “Astroway” (emails από no-reply@astroway.life, στην τραπεζική δήλωση - “Astroway”), αυτό είναι άλλη εταιρεία, astroway.life, όχι εμείς. Δεν έχουμε πρόσβαση στον λογαριασμό ή στις πληρωμές σας σε αυτήν την υπηρεσία, επομένως δεν μπορούμε να τις ακυρώσουμε ή να επιστρέψουμε τα χρήματα. Τι να κάνετε:

1. Απαντήστε απευθείας στο email από no-reply@astroway.life και χρησιμοποιήστε το link “αποχώρηση / ακύρωση” στο κάτω μέρος του.
2. Αν δεν απαντήσουν: επικοινωνήστε με την τράπεζά σας ή τον εκδότη της κάρτας (π.χ. η χρέωση στην δήλωση - “Astroway”· merchant - TrafficLeader OÜ ή ABCMobile OÜ / SKYREAD.PRO, Εσθονία) και ζητήστε να μπλοκαριστούν οι επαναλαμβανόμενες χρεώσεις ή να γίνει επιστροφή (chargeback).