Χάρτα Καταλόγου: πώς είναι οργανωμένοι οι 700+ endpoints του AstroWay

Ο κατάλογος AstroWay έχει ήδη 758 endpoints σε 57 ομάδες. Σε τέτοιο μέγεθος το κύριο ερώτημα του ενσωματωτή δεν είναι «αν θα υπάρχει επαρκής κάλυψη», αλλά «πώς να μην χαθεί». Αυτό το άρθρο είναι ένας χάρτης: πώς ο κατάλογος χωρίζεται σε domains και πώς να βρεις αυτό που χρειάζεσαι σε ένα λεπτό.

Ανεξάρτητα από το domain, κάθε υπολογιστικό endpoint έχει την ίδια μορφή:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

Το σώμα - JSON με τα δεδομένα γέννησης (ημερομηνία, ώρα, συντεταγμένες) ή ειδικές παραμέτρους για την τεχνική. Η απάντηση είναι πάντα { "ok": true, "data": {...} } ή { "ok": false, "error": {...} }. Καμία GraphQL, κανένα ξεχωριστό auth-flow στο domain: ένα κλειδί στο header X-Api-Key, μία μορφή απάντησης.

Αυτό σημαίνει ότι το wrapper που γράφεις για το natal chart, ταιριάζει και για BaZi και για ρούνες – αλλάζει μόνο η διαδρομή και το σχήμα του σώματος.

Ο κατάλογος ομαδοποιείται σε μεγάλα domains. Εδώ είναι ένας χάρτης με πραγματικούς μετρητές (οι αριθμοί λαμβάνονται από το manifest σε κάθε build, οπότε εδώ είναι πάντα ενημερωμένοι):

Τα υπόλοιπα – AI-ερμηνείες, ωροσκόπια, βοηθητικά endpoints (σημεία, πλανήτες, όψεις) και συστημικά (health, usage, openapi).

174 βεδικά endpoints – είναι περισσότερα από όλο το δυτικό μέρος. Ο λόγος είναι απλός: η βεδική παράδοση είναι πιο τυποποιημένη. Εκεί όπου η δυτική αστρολογία έχει ένα σύνολο σπιτιών, η βεδική έχει 16 divisional-χάρτες (varga), πολλές συστήματα dasha, δεκάδες yogas με σαφείς κανόνες. Κάθε ένα από αυτά είναι ένα ξεχωριστό endpoint με καθορισμένο αποτέλεσμα.

Αν χτίζεις για την ινδική αγορά, αυτό είναι ο πυρήνας του προϊόντος, όχι ένα πρόσθετο.

Ανεξάρτητα από την εξωτική τεχνική, οι θέσεις των πλανητών υπολογίζονται με έναν πυρήνα στο Swiss Ephemeris (WASM). Ο ίδιος πυρήνας λειτουργεί τόσο στο πρόγραμμα περιήγησης της εφαρμογής μας όσο και στον API server – μία βάση κώδικα, χωρίς διαφορές. Τα υπολογιστικά endpoints καλύπτονται από 873 snapshot-tests, που σε κάθε PR συγκρίνονται με τα πρότυπα δεδομένα. Περισσότερα για αυτό σε ξεχωριστό άρθρο για την ακρίβεια CI.

Τρία μονοπάτια, από το πιο γρήγορο:

1. OpenAPI-οδηγός – /docs/api/ δημιουργείται απευθείας από την prod-specification openapi.json. Οι ομάδες στο sidebar = τα domains παραπάνω. Κάθε endpoint έχει schema σώματος, παράδειγμα και κουμπί «δοκιμή».
2. MCP-κατάλογος – αν είσαι σε Claude ή Cursor, ολόκληρος ο κατάλογος είναι διαθέσιμος ως σύνολο εργαλείων μέσω mcp.astroway.info. Ο πράκτορας βρίσκει αυτόματα το κατάλληλο endpoint με βάση την περιγραφή.
3. Αναζήτηση στην προδιαγραφή – curl https://api.astroway.info/v1/openapi.json επιστρέφει το πλήρες machine‑readable contract. Χρήσιμο για code generation του δικού σου client.

Το κλειδί στο dashboard/sign-up δίνει 10 000 credits ανά μήνα – αρκετά για να περάσεις από δεκάδες domains και να καταλάβεις τι είναι δικό σου. Δεν χρειάζεται να μάθεις ολόκληρο τον κατάλογο: πάρε το domain σου, και τα υπόλοιπα θα περιμένουν όταν τα χρειαστείς.