Reports API - 16 έτοιμες αναφορές PDF με το δικό σας brand

Στέλνετε μια ημερομηνία γέννησης και παίρνετε ένα έτοιμο έγγραφο. Όχι JSON από το οποίο πρέπει να στήσετε PDF, αλλά το ίδιο το PDF: σελιδοποιημένο, με το λογότυπό σας, τον δικό σας τίτλο αναφοράς και χωρίς καμία αναφορά σε εμάς μέσα του.

Δεκαέξι τέτοιες αναφορές λειτουργούν ήδη. Μαζί με τον dispatcher, το ιστορικό εξαγωγών και πέντε AI αφηγήσεις, αυτό κάνει 23 διαδρομές κάτω από το /v1/reports/*.

Κατάλογος

Κάθε γραμμή έχει έτοιμο δείγμα. Δεν είναι mockup: το αρχείο δημιουργήθηκε με την ίδια κλήση που είναι τυπωμένη στην αναφορά αυτού του endpoint και εκδίδεται ξανά μαζί με τα templates.

Ο αριθμός σελίδων είναι αυτός που έβγαλε το συγκεκριμένο δείγμα, μετρημένος στις 2026-09-21. Διαφέρει από χάρτη σε χάρτη: περισσότερες όψεις σημαίνουν περισσότερες γραμμές, και το relocation προσθέτει δύο με τρεις σελίδες για κάθε πόλη (4 σελίδες για μία πόλη, 13 για πέντε).

Endpoint	Τι περιέχει	Σελίδες	Credits	Δείγμα
/v1/reports/natal	Μεγάλη τριάδα, πλανήτες, οίκοι, όψεις	3	5 000	PDF
/v1/reports/synastry	Όψεις μεταξύ δύο χαρτών, ισορροπία στοιχείων	2	5 000	PDF
/v1/reports/transit-yearly	Πρόγνωση διελεύσεων για το επιλεγμένο έτος	5	5 000	PDF
/v1/reports/relocation	Αρχικός χάρτης, έως 5 πόλεις, πλανήτες που άλλαξαν οίκο, κοντινές γραμμές, 19 τομείς ζωής	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna και nakshatra, αστρικές θέσεις, mahadasha Vimshottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, εντοπισμένα rin, upaya	2	5 000	PDF
/v1/reports/gemstone	Προτεινόμενοι λίθοι με mantra, λίθοι που δεν πρέπει να φορεθούν, κατάσταση των graha	7	5 000	PDF
/v1/reports/human-design	Βασικές παράμετροι, κέντρα, κανάλια	2	5 000	PDF
/v1/reports/muhurta	Ταξινομημένες ευνοϊκές ημέρες για μία δραστηριότητα	4	5 000	PDF
/v1/reports/love	Βασικά σημεία του έρωτα, μεγάλη τριάδα, όψεις	2	5 000	PDF
/v1/reports/career	Βασικά σημεία καριέρας, πλαίσιο προσωπικότητας, όψεις	2	5 000	PDF
/v1/reports/money	Βασικά οικονομικά σημεία, οίκοι, όψεις	3	5 000	PDF
/v1/reports/business	Βασικά σημεία επιχείρησης, οίκοι, όψεις	2	5 000	PDF
/v1/reports/child	Βασικά χαρακτηριστικά, μεγάλη τριάδα, πλανήτες	2	5 000	PDF
/v1/reports/stellaforge	Αφίσα του χάρτη σε μία σελίδα: πλανήτες, ισορροπία, βασικές όψεις	1	5 000	PDF
/v1/reports/tarot	Περιγραφή του ανοίγματος και των καρτών	2	100	PDF

Το ταρώ κοστίζει πενήντα φορές λιγότερο, γιατί δεν χρειάζεται εφημερίδες: μία σελίδα ανοίγματος χωρίς αστρονομικούς υπολογισμούς.

Μία διαδρομή αντί για δεκαέξι

Το POST /v1/reports/generate δέχεται το πεδίο report_type και κάνει ό,τι και η ξεχωριστή διαδρομή. Δώδεκα τύποι: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Για το SDK αυτό σημαίνει μία μέθοδο αντί για δώδεκα, για το MCP ένα εργαλείο αντί για δώδεκα. Η τιμή είναι ίδια: η κλήση μέσω του dispatcher χρεώνει ακριβώς όσο η άμεση διαδρομή.

PDF ή HTML

Από προεπιλογή έρχεται PDF και ένας σύνδεσμος προς αυτό. Το ?format=html επιστρέφει έτοιμη σελίδα HTML κατευθείαν στην απάντηση, χωρίς render και χωρίς αποθήκευση: βολικό όταν ενσωματώνετε την αναφορά στη δική σας σελίδα ή θέλετε να βάλετε δικό σας CSS.

Ο σύνδεσμος προς το PDF ισχύει 24 ώρες. Αυτό είναι σκόπιμο: δεν φιλοξενούμε ξένα έγγραφα επ’ αόριστον. Κατεβάστε το αρχείο αμέσως μετά την απάντηση. Το GET /v1/reports/history δείχνει δωρεάν τις τελευταίες εξαγωγές αυτού του κλειδιού, και μια ληγμένη εγγραφή έρχεται με expired: true.

Το δικό σας brand, όχι το δικό μας

Το whitelabel δέχεται ένα αντικείμενο με 15 πεδία: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing και πέντε χρώματα (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

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

curl -X POST https://api.astroway.info/v1/reports/natal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00",
                   "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
        "whitelabel": { "companyName": "Zoryana Studio",
                        "reportName": "Your Birth Blueprint",
                        "themeColor": "#7c3aed",
                        "footerText": "zoryana.example" } }'

Στο παραγόμενο έγγραφο υπάρχει το όνομα του studio, ο δικός σας τίτλος αναφοράς, το χρώμα έμφασης στις επικεφαλίδες των ενοτήτων και το δικό σας υποσέλιδο. Η λέξη AstroWay δεν εμφανίζεται ούτε μία φορά.

Εναλλακτική για όσους δεν θέλουν να επαναλαμβάνουν το αντικείμενο σε κάθε αίτημα: το whitelabel: true παίρνει την αποθηκευμένη ρύθμιση του λογαριασμού (/v1/whitelabel/config), και το POST /v1/whitelabel/preview σχεδιάζει ένα δείγμα γενέθλιας αναφοράς με αυτήν, για να τη δείτε πριν τη δείξετε στον πελάτη.

Έτοιμη εφαρμογή για clone

Ζωντανό demo και κώδικας στο GitHub, MIT.

Το γραφείο του επαγγελματία: τα στοιχεία του πελάτη αριστερά, το έτοιμο PDF δεξιά. Κάθε πλακίδιο αναφοράς δείχνει την τιμή σε credits πριν από το κλικ και οδηγεί στο έτοιμο δείγμα. Το white-label ενεργοποιείται με ένα checkbox. Το backend είναι μία διαδρομή χωρίς εξαρτήσεις, γιατί εκεί ακριβώς βρίσκεται η ουσία: ο browser δεν μπορεί να καλέσει το API απευθείας, άρα το κλειδί ζει στον server.

git clone https://github.com/astroway/starter-practice
cd starter-practice && npm install
cp .env.example .env     # your key goes here
npm run dev

Τέσσερα πράγματα που αξίζει να κρατήσετε. Η τιμή φαίνεται εκεί όπου παίρνεται η απόφαση: ο server επιστρέφει το X-Credits-Used πίσω στη σελίδα και όχι μόνο στο log. Οι δεκαέξι αναφορές έχουν τέσσερις μορφές αιτήματος, όχι δεκαέξι. Το ίδιο αίτημα τη δεύτερη φορά κοστίζει μηδέν, γιατί η cache απαντήσεων επιστρέφει το ίδιο αρχείο. Και το ALLOWED_REPORTS περιορίζει τι ακριβώς δέχεται να κάνει render το instance: το δημόσιο demo κάνει render μόνο το άνοιγμα ταρώ (/v1/reports/tarot, 100 credits), γιατί μια σελίδα στο ανοιχτό internet που φτιάχνει γενέθλια αναφορά (/v1/reports/natal, 5 000) για οποιονδήποτε ξοδεύει το μηνιαίο δωρεάν όριο με δύο κλικ.

Γλώσσες

Το πεδίο language δέχεται 21 κωδικούς. Πλήρως μεταφρασμένες είναι τρεις: ουκρανικά, αγγλικά, ρωσικά. Για τις υπόλοιπες δεκαοκτώ τοπικοποιούνται τα ονόματα των ζωδίων, ενώ οι επικεφαλίδες και οι εξηγήσεις μένουν στα αγγλικά: μια γερμανική αναφορά θα γράψει “Löwe” κάτω από την επικεφαλίδα “Planets”.

Το λέμε ευθέως, γιατί η αναφορά είναι έγγραφο που ο πελάτης σας κρατά. Αν την πουλούσατε ως γερμανική επειδή είδατε γερμανικά ονόματα ζωδίων στο παράδειγμα, η δυσάρεστη έκπληξη θα ήταν στην πλευρά του πελάτη, όχι στη δική μας. Η αναφορά muhurta είναι προς το παρόν ολόκληρη στα αγγλικά.

Προσοχή

Μετρήθηκε στις 2026-09-20. Αν χρειάζεστε μια συγκεκριμένη γλώσσα πλήρως, γράψτε μας: η ουρά χειροκίνητων μεταφράσεων προχωρά με βάση τη ζήτηση, όχι με βάση μια λίστα.

Πόσες αναφορές βγαίνουν σε κάθε πρόγραμμα

Το /v1/reports/natal και τα υπόλοιπα PDF κοστίζουν 5 000 credits, οπότε το μηνιαίο όριο του προγράμματος μετατρέπεται απλά σε αριθμό αναφορών:

Πρόγραμμα	Credits/μήνα	Αναφορές PDF	Αναφορές ταρώ
Free	10 000	δεν διατίθενται αναφορές	δεν διατίθενται
Indie, $5	50 000	10	500
Starter, $19	200 000	40	2 000
Pro, $59	800 000	160	8 000
Business, $199	3 500 000	700	35 000
Reports Pack, $99	500 000	100	5 000

Στο Free οι αναφορές είναι κλειστές σκόπιμα: ένα PDF σημαίνει δευτερόλεπτα δουλειάς του Chrome από την πλευρά μας, και το δωρεάν πρόγραμμα δεν τα καλύπτει. Η φθηνότερη είσοδος είναι το Indie στα $5.

Το Reports Pack είναι ξεχωριστό πρόσθετο για όσους χρειάζονται μόνο αναφορές: $99 τον μήνα, 500 000 credits, δηλαδή 100 PDF στα 99 σεντ το ένα, με white-label. Ένα κλειδί αυτού του προγράμματος έχει πρόσβαση μόνο στα /v1/reports/* και /v1/whitelabel/*.

Αν χρειάζεστε κείμενο και όχι έγγραφο

Πέντε endpoints επιστρέφουν AI αφήγηση ως JSON, χωρίς σελιδοποίηση και χωρίς PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. 250 credits το καθένα. Χρησιμοποιήστε τα όταν το κείμενο πηγαίνει στο δικό σας layout, εφαρμογή ή newsletter.

Η γενέθλια αναφορά υποστηρίζει και μεικτή λειτουργία: το enrich: true προσθέτει AI αφήγηση μέσα στο PDF. Στον ίδιο δοκιμαστικό χάρτη αυτό κάνει 5 σελίδες αντί για 3.