Reports API - आपके ब्रांड के साथ 16 तैयार PDF रिपोर्ट

आप अपने जन्म तिथि भेजते हैं और तुरंत एक तैयार दस्तावेज़ प्राप्त करते हैं। नहीं JSON, जिसे PDF के लिए डिज़ाइन किया जाना है, बल्कि एक ही PDF: पृष्ठों के साथ डिज़ाइन किया गया, आपके लोगो के साथ, आपके रिपोर्ट के नाम के साथ और हमारे बारे में किसी भी उल्लेख के बिना।

अब तक 16 ऐसे रिपोर्ट काम कर रहे हैं। डैशबोर्ड, निर्यात इतिहास और पांच AI कहानियों के साथ, /v1/reports/* के तहत 23 तरीके हैं।

कैटलॉग

हर पंक्ति में एक तैयार उदाहरण है। यह एक मॉडल नहीं है: यह एक फ़ाइल है जिसे उसी कॉल से जनरेट किया गया है जो इस एंडपॉइंट के दस्तावेज़ में छपा हुआ है, और टेम्प्लेट के साथ फिर से जारी किया जाता है।

पृष्ठों की संख्या वही है जो इस उदाहरण ने दी है, मापा गया 2026-09-21। यह कार्टोग्राफी से भिन्न होता है: अधिक एस्पेक्ट्स अधिक पंक्तियाँ हैं, और relocation हर शहर के लिए दो से तीन पृष्ठ जोड़ता है (एक शहर के लिए चार पृष्ठ, पांच शहरों के लिए 13 पृष्ठ)।

एंडपॉइंट	अंदर क्या है	पृष्ठ	क्रेडिट्स	उदाहरण
/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

टारोट 50 गुना सस्ता है क्योंकि इसमें एफेमेरिड्स नहीं होते हैं: एक पृष्ठ रीडिंग बिना खगोलीय गणनाओं के।

गहराई: standard या extended

/v1/reports/natal (और /v1/reports/generate के साथ report_type: "natal") depth को स्वीकार करता है। standard यह दस्तावेज़ है, 5000 क्रेडिट्स। extended 10000 क्रेडिट्स का है और कार्टोग्राफी का चक्र जोड़ता है, साथ ही सूर्य से प्लूटो, हिरॉन और एसेंडेंट के लिए हर एक के लिए एक खंड जोड़ता है, जो कि राशि में होता है: बारह खंड, हर एक में दो से चार पृष्ठ संपादित पाठ (PDF उदाहरण, 13 पृष्ठ) /v1/natal-texts से उसी कॉर्पस से। कोई भी अनुरोध पर जनरेट नहीं किया जाता है, इसलिए वही कार्टोग्राफी वही दस्तावेज़ देता है।

खंड 20 भाषाओं में हैं, वेबसाइट की भाषाओं में; depth: "extended" किसी अन्य भाषा के साथ अस्वीकार कर दिया जाता है, 400 के साथ, नहीं कि किसी अन्य भाषा से भर दिया जाता है। अन्य रिपोर्ट प्रकार अभी एक ही गहराई के हैं: उनके लंबे खंड अभी लिखे नहीं गए हैं।

एक रास्ता बजाय 16

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 या Markdown

हर रिपोर्ट प्रकार और डैशबोर्ड भी format स्वीकार करता है: अनुरोध के शरीर में या अनुरोध लाइन में ?format= के रूप में (एक बार भेजें; दो अलग-अलग मान 400 देते हैं)। मूल्य तीनों में समान है, क्योंकि आप दस्तावेज़ के लिए भुगतान करते हैं, नहीं कि उस फ़ाइल में जो आता है।

format	क्या लौटाया जाता है	संग्रहित किया जाता है
pdf (डिफ़ॉल्ट)	JSON के साथ url PDF, page_count और expires_at	24 घंटे या retain_days
html	दस्तावेज़ स्वयं, Content-Type: text/html	संग्रहित नहीं किया जाता
markdown	वही दस्तावेज़ मार्कडाउन में, Content-Type: text/markdown	संग्रहित नहीं किया जाता

HTML एक ही स्वतंत्र फ़ाइल है: स्टाइल्स अंदर, कार्टोग्राफी का चक्र और वासु की योजना एकीकृत SVG के रूप में, बिना स्क्रिप्ट और बिना बाहरी फ़ॉन्ट। यह वही पृष्ठ है जिस से PDF प्रिंट होता है, उसी व्हाइट-लेबल ब्लॉक के साथ: कंपनी का नाम, रिपोर्ट का नाम, रंग और फुटर। एकमात्र बाहरी लिंक आपका logoUrl है, जो आपकी https इमेज पर एक लिंक के रूप में रहता है, जैसे कि PDF में। हर नाम, स्थान और टेक्स्ट जो आप भेजते हैं, स्क्रीन किया जाता है, इसलिए <img onerror=...> जैसे नाम टेक्स्ट के रूप में प्रिंट होते हैं। दस्तावेज़ को अपने पृष्ठ में या iframe में इंसर्ट किया जा सकता है।

Markdown वही शीर्षक, टेक्स्ट और टेबल्स रखता है। शीर्षक के स्तर संरक्षित हैं: # रिपोर्ट का नाम है, ## खंड, ### उपखंड, उसी क्रम में जो कि PDF में है, इसलिए पंक्तियों को जो ## से शुरू होता है, खंडों में विभाजित किया जाता है। GitHub के रूप में टेबल्स। चित्र (चक्र, योजना) छोड़ दिया जाता है, उसके स्थान पर एक नोट का एक पंक्ति। हर वह वर्ण जो मार्कडाउन या HTML के अंदर रेंडरर पढ़ता है और इसे टैग के रूप में समझता है, बैकस्लैश से स्क्रीन किया जाता है।

curl -X POST "https://api.astroway.info/v1/reports/natal?format=markdown" \
  -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 },
        "language": "uk" }'

PDF का लिंक 24 घंटे तक जीवित रहता है। क्लाइंट को लंबे समय तक लिंक देने के लिए, ?retain_days=30 (अधिकतम 90) जोड़ें: फ़ाइल उतने दिनों तक रहेगी, और expires_at प्रतिक्रिया में यह दिखाएगा। हम अन्य दस्तावेज़ होस्ट नहीं करते हैं, और फ़ाइल को पहले से हटाने के लिए DELETE /v1/reports/files/{filename} का उपयोग करें, बिना किसी लागत के। फ़ाइल में वही होता है जो आप भेजते हैं, साथ ही नाम, इसलिए संग्रहण की अवधि DPA के खंड 2 में वर्णित है। /v1/reports/history के माध्यम से GET मुफ़्त में पिछले निर्यात दिखाता है, और समाप्त हो चुके रिकॉर्ड 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 अकाउंट के संग्रहित कॉन्फ़िगरेशन को लेता है। इसे सेट करें रिपोर्ट ब्रांडिंग पृष्ठ पर कैबिनेट: कंपनी का नाम, रिपोर्ट का नाम, संपर्क, लोगो और दो रंग, नैटाल रिपोर्ट के उदाहरण के साथ प्रिव्यू के साथ। वही सेटिंग्स API की कुंजी के माध्यम से /v1/whitelabel/config और /v1/whitelabel/logo के माध्यम से उपलब्ध हैं, और POST /v1/whitelabel/preview एक PDF उदाहरण बनाता है। ऑब्जेक्ट में भेजे गए फ़ील्ड संग्रहित किए गए फ़ील्ड से प्राथमिकता रखता है।

तैयार एप्लिकेशन जिसे क्लोन किया जा सकता है

जीवित डेमो और GitHub पर कोड, MIT लाइसेंस।

प्रैक्टिशनर की टेबल: क्लाइंट डेटा बाएं ओर, तैयार PDF दाएं ओर। हर रिपोर्ट टाइल मूल्य क्रेडिट में दिखाता है क्लिक से पहले और तैयार उदाहरण पर ले जाता है। व्हाइट-लेबल टॉगल किया जा सकता है। बैकएंड एक ही रूट है बिना डिपेंडेंसी के, क्योंकि यही इसका सार है: ब्राउज़र सीधे 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 को पृष्ठ पर वापस भेजता है, नहीं कि केवल लॉग में। 16 रिपोर्ट चार फॉर्मेट्स के होते हैं, नहीं कि 16। वही अनुरोध दूसरी बार शून्य की लागत का होता है, क्योंकि प्रतिक्रिया के कैश से वही फ़ाइल मिलती है। और ALLOWED_REPORTS सीमित करता है कि कौन सी इंस्टेंस रेंडर करने के लिए सहमत होगा: सार्वजनिक डेमो केवल टारोट रीडिंग (/v1/reports/tarot, 100 क्रेडिट) रेंडर करता है, क्योंकि ओपन इंटरनेट का पृष्ठ जो नैटाल रिपोर्ट (/v1/reports/natal, 5,000 क्रेडिट) किसी को भी बनाता है, मुफ़्त मासिक लिमिट दो क्लिक में खर्च हो जाता है।

भाषाएँ

language फ़ील्ड 21 कोड स्वीकार करता है। पूरी तरह से अनुवादित तीन: यूक्रेनी, अंग्रेज़ी, रूसी। शेष 18 के लिए राशि के नाम अनुवादित होते हैं, जबकि शीर्षक और व्याख्याएँ अंग्रेज़ी में रहती हैं: जर्मन रिपोर्ट “Löwe” लिखेगा “Planets” के शीर्षक के नीचे।

हम इसे सीधे लिखते हैं, क्योंकि रिपोर्ट एक दस्तावेज़ है जिसे आपकी क्लाइंट अपने पास रखती है। इसे जर्मन के रूप में बेचना, जर्मन राशि के नामों को उदाहरण में देखकर, क्लाइंट की ओर से एक असुविधाजनक खुलासा होगा, नहीं कि हमारा। muhurta रिपोर्ट अभी पूरी तरह से अंग्रेज़ी है।

सावधानी

मापा गया 2026-09-20। यदि आपको एक विशिष्ट भाषा की पूरी आवश्यकता है, तो लिखें: अनुवाद की कतार मांग पर चलती है, नहीं कि सूची पर।

एक मासिक योजना में कितनी रिपोर्ट्स आती हैं

/v1/reports/natal और अन्य PDF 5,000 क्रेडिट्स की लागत के हैं, इसलिए मासिक योजना की सीमा को रिपोर्ट की संख्या में सीधे रूपांतरित किया जाता है:

योजना	क्रेडिट्स/महीना	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 हमारे पक्ष पर रेंडरिंग के सेकंड होते हैं, और मुफ़्त टैरिफ उन्हें कवर नहीं करता। सबसे सस्ती प्रवेश Indie $5 पर है।

Reports Pack एक अलग एड-ऑन है उन लोगों के लिए जिनके केवल रिपोर्ट्स की आवश्यकता है: $99 प्रति माह, 1,500,000 क्रेडिट्स, अर्थात् 300 PDF प्रति 33 सेंट प्रति एक, व्हाइट-लेबल के साथ। यह Pro से PDF के लिए सस्ता है, क्योंकि कुंजी केवल रिपोर्ट्स के लिए ही जाती है। इस योजना की कुंजी केवल /v1/reports/* और /v1/whitelabel/* में जाती है।

रिपोर्ट्स का पुनर्विक्रय: एक PDF का आपका खर्च क्या है

यदि आप अपने ग्राहकों को रिपोर्ट्स बेचते हैं, तो एक संख्या महत्वपूर्ण है: एक PDF आपकी मात्रा पर आपका खर्च क्या है। योजना की सीमा के भीतर यह योजना का मूल्य है, विभाजित रिपोर्ट की संख्या से। सीमा से ऊपर हर PDF ओवरेज के रूप में जाता है, जो योजना के ओवरेज दर के हर 10,000 क्रेडिट्स से अधिक पर गिना जाता है, इसलिए 5,000 क्रेडिट्स का एक PDF ओवरेज दर के आधे मूल्य का होता है।

योजना	योजना में 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 केवल रिपोर्ट्स और व्हाइट-लेबल।

आपका मार्जिन आप ही तय करते हैं। 300 PDF पर Reports Pack पर आपका खर्च $99 प्रति माह है। प्रति एक $9 पर $2700 की आय, $99 खर्चों के खिलाफ, प्रति एक $19 पर $5700। रिटेल मूल्य की सलाह नहीं दी जाती, लेकिन गणित समान है किसी भी मूल्य पर: आपका मूल्य 33 सेंट मिनस।

विस्तृत नैटाल रिपोर्ट मूल्य का दो गुना होता है, इसलिए हर योजना पर PDF का मूल्य दोगुना होता है: $0.66 Reports Pack में।

दो चीजें वास्तविक खर्च को और कम करती हैं। वही अनुरोध समान डेटा के साथ वही फ़ाइल कैश प्रतिक्रिया से लौटाता है और कोई लागत नहीं होती, इसलिए एक ग्राहक जो रिपोर्ट दो बार डाउनलोड करता है, एक बार ही भुगतान किया जाता है। और वार्षिक योजना 9 की दर पर 12 महीने की होती है, और Reports Pack $0.25 प्रति PDF पर आती है।

बिक्री से पहले उदाहरणों को खोलें: हर एक वही फ़ाइल है जो API लौटाता है, और whitelabel के साथ आपका नाम और रंग मानक स्थान पर आते हैं।

यदि टेक्स्ट की आवश्यकता है, नहीं दस्तावेज़

पांच एंडपॉइंट्स AI कहानी JSON के रूप में लौटाते हैं, बिना लेआउट और बिना PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative। हर एक 250 क्रेडिट्स का है। उन्हें तब लें जब टेक्स्ट आपकी स्वयं की लेआउट, एप्लिकेशन या ईमेल में जाता है।

नैटाल रिपोर्ट मिश्रित मोड में भी काम करता है: enrich: true AI कहानी को PDF के अंदर जोड़ता है। उसी परीक्षण कार्टोग्राफी पर यह 5 पृष्ठ बनाता है बजाय 3।