🕓 पोस्ट दिनांक 2026-04-14, अंतिम अपडेट 2026-05-09. TS / Python / PHP SDK अब सार्वजनिक रजिस्ट्री पर हैं —
@astroway/sdk(npm),astroway(PyPI),astroway/sdk(Packagist)। विवरण changelog पर देखें।
तुम्हें कोड से जन्म कुंडली की गणना करनी है। यहाँ 5 मिनट में शून्य से लेकर कार्यशील JSON तक का सबसे छोटा रास्ता है।
चरण 1: API कुंजी प्राप्त करें (30 सेकंड)
Section titled “चरण 1: API कुंजी प्राप्त करें (30 सेकंड)”api.astroway.info/dashboard/sign-up पर रजिस्टर करें। मुफ्त योजना: 10,000 क्रेडिट / माह। बिना कार्ड के।
dashboard पर “Create key” → “Production” पर क्लिक करें और कॉपी करें। कुंजियाँ aw_live_aB3xY7pQ9rN2mK4jH8vC5tL6wZ1fD0eR जैसे दिखती हैं।
टिप: aw_test_ उपसर्ग वाली sandbox कुंजियाँ भी हैं — ये क्रेडिट नहीं काटतीं। विकास के दौरान इनका उपयोग करें।
चरण 2: SDK स्थापित करें
Section titled “चरण 2: SDK स्थापित करें”TypeScript
Section titled “TypeScript”npm install @astroway/sdkPython
Section titled “Python”pip install astrowayदोनों SDK 723 एंडपॉइंट को टाइप किए गए अनुरोधों और प्रतिक्रियाओं के साथ कवर करते हैं।
चरण 3: पहली जन्म कुंडली
Section titled “चरण 3: पहली जन्म कुंडली”TypeScript
Section titled “TypeScript”import { Astroway } from '@astroway/sdk';
const client = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY!,});
const chart = await client.chart({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, // UTC+3, कीव में गर्मी का समय latitude: 50.4501, longitude: 30.5234, houseSystem: 'P', // प्लेसिडस});
console.log(`सूर्य: ${chart.planets[0].sign} ${chart.planets[0].longitude}° पर`);console.log(`ASC: ${chart.houses.ascendant}°`);console.log(`एस्पेक्ट्स: ${chart.aspects.length}`);चलाएं:
ASTROWAY_API_KEY=aw_live_... npx tsx chart.tsPython
Section titled “Python”from astroway import Astroway
client = Astroway(api_key="aw_live_your_key_here")
chart = client.chart( date="1990-07-14", time="14:30:00", timezone_offset=3, latitude=50.4501, longitude=30.5234, house_system="P",)
print(f"सूर्य: {chart['planets'][0]['sign']} {chart['planets'][0]['longitude']}° पर")print(f"ASC: {chart['houses']['ascendant']}°")print(f"एस्पेक्ट्स: {len(chart['aspects'])}")चलाएं:
ASTROWAY_API_KEY=aw_live_... python3 chart.pyAPI क्या लौटाता है
Section titled “API क्या लौटाता है”प्रतिक्रिया में चार मुख्य भागों वाला JSON ऑब्जेक्ट आता है:
planets
Section titled “planets”12 ऑब्जेक्ट्स (सूर्य, चंद्र, बुध, शुक्र, मंगल, बृहस्पति, शनि, यूरेनस, नेपच्यून, प्लूटो, उत्तरी नोड, चिरॉन) का एक ऐरे:
{ "name": "सूर्य", "longitude": 111.87, // डिग्री में क्रांतिवृत्तीय देशांतर "latitude": 0.0, "speed": 0.955, // दिन में डिग्री (नकारात्मक = प्रतिगामी) "sign": "cancer", "signIndex": 3, "house": 10, "retrograde": false}houses
Section titled “houses”12 घरों के कस्प और साथ ही ASC व MC:
{ "system": "P", "cusps": [12.34, 43.21, ...], // 12 मान "ascendant": 12.34, "mc": 280.12}aspects
Section titled “aspects”ग्रहों के बीच एस्पेक्ट्स का ऐरे:
{ "planet1": "सूर्य", "planet2": "चंद्र", "type": "sextile", // conjunction, opposition, trine, square, sextile, quincunx "orb": 1.36, // डिग्री में सटीकता से विचलन "applying": true}chartSect
Section titled “chartSect”"diurnal" (जन्म के समय सूर्य क्षितिज के ऊपर) या "nocturnal" (नीचे)। शास्त्रीय ज्योतिष में उपयोग होता है।
आगे क्या करें
Section titled “आगे क्या करें”और क्या आजमाएं:
सिनास्ट्री — दो लोगों की संगतता:
const synastry = await client.synastry({ chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 }, chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },});console.log(`संगतता स्कोर: ${synastry.compatibility.score}/100`);जन्म कुंडली पर वर्तमान पारगमन:
const transits = await client.transits({ // जन्म डेटा date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, // पारगमन की तिथि transitDate: '2026-04-14',});वास्तविक पारगमन से दैनिक राशिफल:
const horoscope = await client.horoscopeDaily({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});console.log(horoscope.text);पूर्ण Human Design चार्ट:
const hd = await client.humanDesign({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});console.log(`${hd.type} — ${hd.strategy} — प्रोफाइल ${hd.profile}`);क्रेडिट में लागत
Section titled “क्रेडिट में लागत”- जन्म कुंडली (
/chart): 20 क्रेडिट - सिनास्ट्री: 50 क्रेडिट
- पारगमन: 50 क्रेडिट
- दैनिक राशिफल: 20 क्रेडिट
- Human Design: 50 क्रेडिट
मुफ्त योजना: 10,000 क्रेडिट / माह = 500 जन्म कुंडलियाँ, या 200 सिनास्ट्री, या मिश्रित लोड।
त्रुटि हैंडलिंग
Section titled “त्रुटि हैंडलिंग”हर प्रतिक्रिया में क्रेडिट हेडर शामिल होते हैं:
X-Credits-Used: 20X-Credits-Remaining: 4980X-Credits-Reset: 2026-05-01T00:00:00Zजब क्रेडिट खत्म हो जाते हैं — 402 Payment Required मिलेगा। जब रेट-लिमिट (फ्री: 10 अनुरोध / मिनट) टूटे — 429 Too Many Requests मिलेगा, जिसमें Retry-After हेडर होगा।
SDK टाइप की गई त्रुटियाँ फेंकता है जिन्हें पकड़ा जा सकता है:
try { const chart = await client.chart({ ... });} catch (err) { if (err.code === 'credits_exhausted') { console.log('प्लान अपग्रेड करें या रीसेट होने तक प्रतीक्षा करें'); } else if (err.code === 'rate_limit_exceeded') { console.log(`${err.retryAfter} सेकंड में पुनः प्रयास करें`); }}बस इतना ही
Section titled “बस इतना ही”अब तुम्हारे पास है:
- कार्यशील API कुंजी
- स्थापित SDK
- पहली जन्म कुंडली
- सिनास्ट्री, पारगमन, राशिफल जोड़ने के लिए पर्याप्त उदाहरण
और पढ़ें:
- “शुरू करें” पूर्ण गाइड — और विवरण
- उदाहरण: जन्म कुंडली — गहन walkthrough
- API reference — सभी 723 एंडपॉइंट
वही Swiss Ephemeris जो Solar Fire में है — बस 4 लाइनों के कोड में।
कार्ड के बिना मुफ्त कुंजी। पहले भुगतान तक 5,000 कॉल प्रति माह।