AstroWay/api v2.102.11 · hi
सभी सिस्टम सामान्य हैं

ज्योतिष एपीआई की त्वरित शुरुआत: 5 मिनट में टाइपस्क्रिप्ट और पायथन

एसडीके स्थापित करें, एपीआई कुंजी प्राप्त करें, पहला जन्म चार्ट अनुरोध करें। 5 मिनट - और काम करने वाला जेसन हाथ में (टाइपस्क्रिप्ट और पायथन)।

🕓 पोस्ट दिनांक 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 स्थापित करें”
Terminal window
npm install @astroway/sdk
Terminal window
pip install astroway

दोनों SDK 723 एंडपॉइंट को टाइप किए गए अनुरोधों और प्रतिक्रियाओं के साथ कवर करते हैं।

चरण 3: पहली जन्म कुंडली

Section titled “चरण 3: पहली जन्म कुंडली”
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}`);

चलाएं:

Terminal window
ASTROWAY_API_KEY=aw_live_... npx tsx chart.ts
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'])}")

चलाएं:

Terminal window
ASTROWAY_API_KEY=aw_live_... python3 chart.py

API क्या लौटाता है

Section titled “API क्या लौटाता है”

प्रतिक्रिया में चार मुख्य भागों वाला JSON ऑब्जेक्ट आता है:

12 ऑब्जेक्ट्स (सूर्य, चंद्र, बुध, शुक्र, मंगल, बृहस्पति, शनि, यूरेनस, नेपच्यून, प्लूटो, उत्तरी नोड, चिरॉन) का एक ऐरे:

{
"name": "सूर्य",
"longitude": 111.87, // डिग्री में क्रांतिवृत्तीय देशांतर
"latitude": 0.0,
"speed": 0.955, // दिन में डिग्री (नकारात्मक = प्रतिगामी)
"sign": "cancer",
"signIndex": 3,
"house": 10,
"retrograde": false
}

12 घरों के कस्प और साथ ही ASC व MC:

{
"system": "P",
"cusps": [12.34, 43.21, ...], // 12 मान
"ascendant": 12.34,
"mc": 280.12
}

ग्रहों के बीच एस्पेक्ट्स का ऐरे:

{
"planet1": "सूर्य",
"planet2": "चंद्र",
"type": "sextile", // conjunction, opposition, trine, square, sextile, quincunx
"orb": 1.36, // डिग्री में सटीकता से विचलन
"applying": true
}

"diurnal" (जन्म के समय सूर्य क्षितिज के ऊपर) या "nocturnal" (नीचे)। शास्त्रीय ज्योतिष में उपयोग होता है।

और क्या आजमाएं:

सिनास्ट्री — दो लोगों की संगतता:

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: 20
X-Credits-Remaining: 4980
X-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} सेकंड में पुनः प्रयास करें`);
}
}

अब तुम्हारे पास है:

  • कार्यशील API कुंजी
  • स्थापित SDK
  • पहली जन्म कुंडली
  • सिनास्ट्री, पारगमन, राशिफल जोड़ने के लिए पर्याप्त उदाहरण

और पढ़ें:

AstroWay team

AstroWay API की इंजीनियरिंग टीम। हम Swiss Ephemeris को साफ REST में लपेटते हैं और उन 'न boring' विवरणों के बारे में लिखते हैं जो असल में मायने रखते हैं।

// इस पर बनाएं

वही Swiss Ephemeris जो Solar Fire में है — बस 4 लाइनों के कोड में।

कार्ड के बिना मुफ्त कुंजी। पहले भुगतान तक 5,000 कॉल प्रति माह।

ब्लॉग से और सभी पोस्ट →

Engineering 2026-06-05

Natal Chart API in TypeScript: SDK + React Example

Compute a natal chart in TypeScript with the AstroWay SDK — typed responses, a React component, and where it beats a local ephemeris library.

Ephemeris 2026-06-05

How Accurate Is the Swiss Ephemeris? Verified Benchmarks

Swiss Ephemeris accuracy in numbers — planetary positions under 0.1 arcsecond, exact house cusps, eclipses within a minute — and how AstroWay verifies it.

Ephemeris 2026-06-05

Swiss Ephemeris: REST API vs pyswisseph (When to Use Which)

pyswisseph vs a REST API for Swiss Ephemeris calculations — C dependencies, data files, licensing and deployment compared, with a decision guide.