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

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

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

Κατάλογος

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

Ο αριθμός των σελίδων είναι αυτός που έδωσε αυτό το συγκεκριμένο δείγμα, μετρημένος στις 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	Λάγκνα και Νακσάτρα, πλευρικές θέσεις, Μαχαντάσες Βιμσοτάρι	2	5 000	PDF
/v1/reports/lal-kitab	Κίσματ, Τέβα, εντοπισμένα Ριν, Ουπάγι	2	5 000	PDF
/v1/reports/gemstone	Σύσταση λίθων με μάντρα, λίθοι που δεν πρέπει να φορεθούν, κατάσταση των Γκράχα	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
/v1/reports/vastu	Σχέδιο σπιτιού με μάνταλα, αξιολόγηση, ευρήματα Βάστου με πηγές και διορθώσεις	2	5 000	PDF

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

Βάθος: standard ή extended

Το /v1/reports/natal (και το /v1/reports/generate με report_type: "natal") δέχεται depth. Το standard είναι το παραπάνω έγγραφο, 5000 credits. Το extended κοστίζει 10000 credits και προσθέτει τον τροχό του χάρτη και μια ενότητα για κάθε σώμα από τον Ήλιο μέχρι τον Πλούτωνα, τον Χείρωνα και τον Ωροσκόπο στο ζώδιο: δώδεκα ενότητες, καθεμία δύο έως τέσσερις σελίδες επεξεργασμένου κειμένου (δείγμα PDF, 13 σελίδες) από το ίδιο σώμα που επιστρέφει το /v1/natal-texts. Τίποτα δεν δημιουργείται κατόπιν αιτήματος, οπότε ο ίδιος χάρτης δίνει το ίδιο έγγραφο.

Οι ενότητες είναι διαθέσιμες σε 20 γλώσσες, τις γλώσσες του ιστότοπου. Το depth: "extended" με διαφορετική γλώσσα απορρίπτεται με 400, αντί να συμπληρώνεται από άλλη γλώσσα. Άλλοι τύποι αναφορών έχουν προς το παρόν ένα μόνο βάθος: οι μακροσκελείς ενότητές τους δεν έχουν γραφτεί ακόμη.

Ένα μονοπάτι αντί για δεκαέξι

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

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

PDF ή HTML

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

Ο σύνδεσμος PDF είναι ενεργός για 24 ώρες. Για να δώσεις στον πελάτη έναν σύνδεσμο για μεγαλύτερο διάστημα, πρόσθεσε ?retain_days=30 (έως 90): το αρχείο θα παραμείνει για τόσες ημέρες, και το expires_at στην απάντηση θα το δείξει. Δεν φιλοξενούμε ξένα έγγραφα επ’ αόριστον, και μπορείς να διαγράψεις ένα αρχείο νωρίτερα μέσω του DELETE /v1/reports/files/{filename}, δωρεάν. Το αρχείο περιέχει ό,τι έστειλες, μαζί με το όνομα, επομένως η περίοδος διατήρησης περιγράφεται στο DPA, ενότητα 2. Το GET /v1/reports/history εμφανίζει δωρεάν τις τελευταίες εξαγωγές αυτού του κλειδιού, και μια ληγμένη εγγραφή επιστρέφεται με expired: true.

Η επωνυμία σου, όχι η δική μας

Το 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" } }'

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

Μια εναλλακτική για όσους δεν θέλουν να επαναλαμβάνουν το αντικείμενο σε κάθε αίτημα: το whitelabel: true χρησιμοποιεί την αποθηκευμένη διαμόρφωση του λογαριασμού. Όρισε την στη σελίδα Branding Αναφορών στο προφίλ σου: όνομα εταιρείας, τίτλος αναφοράς, στοιχεία επικοινωνίας, λογότυπο και δύο χρώματα, με προεπισκόπηση ενός δείγματος γενέθλιας αναφοράς. Οι ίδιες ρυθμίσεις είναι διαθέσιμες με το κλειδί μέσω /v1/whitelabel/config και /v1/whitelabel/logo, ενώ το POST /v1/whitelabel/preview δημιουργεί ένα δείγμα σε PDF. Το πεδίο που μεταβιβάζεται στο αντικείμενο έχει προτεραιότητα έναντι του αποθηκευμένου.

Έτοιμη εφαρμογή που μπορείς να κλωνοποιήσεις

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

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

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

Τέσσερα πράγματα που αξίζει να σημειώσεις. Η τιμή εμφανίζεται εκεί που λαμβάνεται η απόφαση: ο διακομιστής επιστρέφει το X-Credits-Used πίσω στη σελίδα, όχι μόνο στο αρχείο καταγραφής. Δεκαέξι αναφορές έχουν τέσσερις μορφές αιτημάτων, όχι δεκαέξι. Το ίδιο αίτημα για δεύτερη φορά κοστίζει μηδέν, επειδή η κρυφή μνήμη απαντήσεων επιστρέφει το ίδιο αρχείο. Και το ALLOWED_REPORTS περιορίζει τι ακριβώς θα συμφωνήσει να αποδώσει η περίπτωση: το δημόσιο demo αποδίδει μόνο το άνοιγμα Ταρώ (/v1/reports/tarot, 100 credits), επειδή μια σελίδα στο ανοιχτό διαδίκτυο που δημιουργεί μια γενέθλια αναφορά (/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	1 500 000	300	15 000

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

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

Μεταπώληση αναφορών: πόσο σου κοστίζει ένα PDF

Αν πουλάς αναφορές στους πελάτες σου, ένας αριθμός έχει σημασία: πόσο σου κοστίζει ένα PDF στον όγκο σου. Εντός του ορίου του πακέτου, αυτή είναι η τιμή του πακέτου διαιρούμενη με τον αριθμό των PDF. Πάνω από το όριο, κάθε PDF χρεώνεται ως υπέρβαση, η οποία υπολογίζεται για κάθε 10.000 credits πάνω από το όριο, οπότε ένα PDF για 5000 credits κοστίζει το μισό της τιμής υπέρβασης του πακέτου.

Πακέτο	PDF στο πακέτο	Τιμή PDF εντός	Κάθε PDF επιπλέον
Indie, $5	10	$0.50	$2.50
Starter, $19	40	$0.48	$2.50
Pro, $59	160	$0.37	$1.50
Reports Pack, $99	300	$0.33	$1.50
Business, $199	700	$0.28	$1.00

Έτσι, το φθηνότερο πακέτο εξαρτάται από το πόσα PDF πουλάς το μήνα, συμπεριλαμβανομένης της υπέρβασης:

PDF ανά μήνα	Φθηνότερο πακέτο	Το κόστος σου	Ανά PDF
10	Indie	$5	$0.50
40	Starter	$19	$0.48
100	Pro	$59	$0.59
160	Pro	$59	$0.37
300	Reports Pack	$99	$0.33
500	Business	$199	$0.40
700	Business	$199	$0.28

Σημεία αλλαγής: Το Starter είναι πιο συμφέρον από το Indie από 16 PDF, το Pro από το Starter από 57, το Reports Pack από το Pro από 187, αν δεν χρειάζεσαι τίποτα άλλο εκτός από αναφορές, το Business από το Reports Pack από 367. Το Pro και το Business ανοίγουν και το υπόλοιπο API, το Pack μόνο αναφορές και white-label.

Το περιθώριο κέρδους το ορίζεις εσύ. Για 300 PDF στο Reports Pack, το κόστος σου είναι $99 το μήνα. Με $9 ανά τεμάχιο, αυτό είναι $2700 έσοδα έναντι $99 κόστους, με $19 είναι $5700. Δεν συνιστούμε λιανική τιμή, αλλά η αριθμητική είναι η ίδια για οποιαδήποτε: η τιμή σου μείον 33 σεντς.

Η εκτεταμένη γενέθλια αναφορά κοστίζει διπλάσια από την τυπική, οπότε σε κάθε παραπάνω πακέτο είναι διπλάσια η τιμή ανά PDF: $0.66 στο Reports Pack.

Δύο πράγματα μειώνουν περαιτέρω το πραγματικό κόστος. Μια επαναλαμβανόμενη αίτηση με τα ίδια δεδομένα επιστρέφει το ίδιο αρχείο από την κρυφή μνήμη απαντήσεων και δεν κοστίζει τίποτα, οπότε ένας πελάτης που κατέβασε την αναφορά δύο φορές χρεώνεται μία φορά. Και το ετήσιο πακέτο είναι 12 μήνες στην τιμή των 9, και το Reports Pack βγαίνει $0.25 ανά PDF.

Πριν πουλήσεις, άνοιξε τα δείγματα: κάθε ένα είναι ακριβώς το αρχείο που επιστρέφει το API, και με το whitelabel το όνομα και τα χρώματά σου αντικαθιστούν τα τυπικά.

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

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

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