ज्योतिष एपीआई

शास्त्रों की परंपरा पर आधारित

कुंडली और फलादेश पाराशरी परंपरा का अनुसरण करते हैं, जैसा बृहत् पाराशर होरा शास्त्र, फलदीपिका, सारावली और जातक पारिजात में बताया गया है। विवाह मिलान में उत्तर भारत का अष्टकूट गुण मिलान और दक्षिण भारत की दस पोरुत्तम पद्धति दोनों उपलब्ध हैं, और वास्तु सोलह दिशा क्षेत्रों तथा वास्तु पुरुष मंडल के पैंतालीस देवताओं पर चलता है।

आपकी कुंजी

हर अनुरोध के साथ अपनी कुंजी अनुरोध शीर्ष में भेजें। हम कुंजी की केवल एकतरफ़ा छाप रखते हैं, इसलिए जो गुप्त कुंजी आपको दिखाई गई थी उसे सुरक्षित रखें; यदि वह कभी लीक हो जाए तो उसे रद्द करके अपने कंसोल से नई कुंजी बना लें।

curl -H "X-API-Key: YOUR_KEY" \
  "https://YOUR_HOST/v1/astro/panchang/sunrise?date=20/10/2026&lat=13.0827&lon=80.2707&tz=5.5"

चौदह भाषाएँ, हर एक अपनी लिपि में

किसी भी अनुरोध में भाषा का मापदंड जोड़ दें। ग्रह, राशियाँ, नक्षत्र और हर फलादेश उसी भाषा की अपनी लिपि और उसके पारंपरिक शब्दों में आते हैं, किसी दूसरी लिपि के मेल के बिना।

lang = en | ta | te | kn | hi | ml | sa | bn | gu | es | mr | pa | or | ur

curl -H "X-API-Key: YOUR_KEY" \
  "https://YOUR_HOST/v1/astro/horoscope/planet-details?dob=11/03/1994&tob=11:40&lat=13.0827&lon=80.2707&tz=5.5&lang=ta"

आप क्या माँग सकते हैं

किसी भी दिन और स्थान का पंचांग, वर्ग कुंडलियों सहित जन्म कुंडली, अष्टकूट और पोरुत्तम मिलान, विंशोत्तरी और अन्य दशाएँ, दोष जाँच, दैनिक से वार्षिक राशिफल, अंक ज्योतिष और वास्तु की मूल बातें। हर मापदंड सहित पूरी सूची नीचे संदर्भ में और डाउनलोड होने वाले विवरण में है।

/v1/astro/panchang/...      panchang, sunrise, hora, choghadiya, festivals
/v1/astro/horoscope/...     planet-details, divisional-charts, ashtakvarga
/v1/astro/extended/...      extended-kundli-details, kp-planets, current-sade-sati
/v1/astro/matching/...      south-match (porutham), ashtakoot, dashakoot
/v1/astro/dashas/...        maha-dasha, antar-dasha, yogini-dasha-main, char-dasha-main
/v1/astro/dosha/...         mangal-dosh, kaalsarp-dosh, pitra-dosh
/v1/astro/prediction/...    daily-moon, weekly-moon, yearly, numerology
/v1/astro/utilities/...     radical-number-details, gem-details, geo-search
/v1/astro/vastu/zones       vastu basics
/v1/vastu/...               plot grid, entrance, score, ayadi

तीन आकारों में संपूर्ण रिपोर्टें

हमारे जाँचे हुए नियम आधारित फलादेश भंडार से बनी संपूर्ण रिपोर्ट माँगें, या उन्हीं कुंडली तथ्यों पर कृत्रिम बुद्धि से लिखा गया वर्णन। हर रिपोर्ट संरचित पाठ, सुसज्जित दस्तावेज़, बोलकर सुनाए गए फलादेश या कुंडली फ़िल्म के रूप में मिलती है, और हर रूप छोटे, मध्यम या विस्तृत आकार में।

curl -X POST "https://YOUR_HOST/v1/astro/report/natal" \
  -H "X-API-Key: YOUR_KEY" -H "content-type: application/json" \
  -d '{"dob":"11/03/1994","tob":"11:40","lat":13.0827,"lon":80.2707,"tz":5.5,
       "lang":"hi","format":"pdf","size":"detailed"}'

format = json | pdf | audio | film
size   = small | medium | detailed
/v1/astro/report/{family}     rule based
/v1/astro/ai_report/{family}  AI narrative

लंबा काम एक कार्य बनकर चलता है

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

POST /v1/astro/ai_report/natal
{ ..., "format": "audio", "size": "medium", "async": true,
  "webhook_url": "https://example.com/hooks/astro" }

202 { "status": "ok", "response": { "job": { "id": "...", "status": "queued",
      "poll_url": "/v1/astro/jobs/..." } } }

GET /v1/astro/jobs/{id}   queued | running | rendering | done | failed

हस्ताक्षरित सूचनाएँ

हर सूचना के साथ एक समय मुहर और आपकी कुंजी की अपनी गुप्त कुंजी से बना हस्ताक्षर होता है। संदेश पर भरोसा करने से पहले हस्ताक्षर जाँचें और जल्दी सफलता का उत्तर दें; यदि उत्तर न मिले तो हम बढ़ते अंतराल पर कुछ बार फिर प्रयास करते हैं।

// Node.js
const crypto = require('crypto');
function verify(rawBody, headers, secret) {
  const ts = headers['x-webhook-timestamp'];
  const expected = 'v1=' + crypto.createHmac('sha256', secret)
    .update(ts + '.' + rawBody).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(headers['x-webhook-signature']));
}

क्रेडिट और क्रेडिट पैक

हर अनुरोध पहले आपकी योजना के मासिक कोटे से क्रेडिट लेता है, फिर आपके पास मौजूद क्रेडिट पैक से। हर उत्तर बताता है कि कितने क्रेडिट लगे और कितने बचे हैं, ताकि कोई अचंभा न हो।

X-Credits-Used: 8
X-Credits-Remaining: 9992

"meta": { "credits": 8, "remaining": 9992, "request_id": "..." }

उचित उपयोग की सीमाएँ

हर कुंजी की योजना के अनुसार प्रति मिनट एक सीमा होती है। सीमा पार होने पर अनुरोध विनम्रता से लौटा दिया जाता है, एक स्पष्ट कोड और फिर से प्रयास करने के समय के संकेत के साथ।

HTTP/1.1 429
Retry-After: 60
X-RateLimit-Limit: 60

{ "status": "error", "error": { "code": "rate_limited", "message": "..." } }

सुरक्षित दोबारा प्रयास

जब आप कुछ नया बनाने वाला अनुरोध भेजें, तो अपनी एक अनोखी अनुरोध कुंजी जोड़ दें। नेटवर्क टूटने पर आप वही अनुरोध फिर भेजें तो आपको पहला उत्तर ही मिलता है और शुल्क कभी दो बार नहीं कटता।

curl -X POST "https://YOUR_HOST/v1/astro/report/match" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Idempotency-Key: order-2026-10-20-0001" \
  -d '{ ... }'

Idempotent-Replayed: true   (on a repeated request)

हर त्रुटि का एक ही रूप

हर अस्वीकृति का रूप एक जैसा होता है: एक छोटा कोड जिस पर आप कार्रवाई कर सकें, एक सरल संदेश और जहाँ उपयोगी हो, सुधारने वाले मापदंड का नाम।

{
  "status": "error",
  "error": { "code": "param_missing", "message": "...", "param": "tob" },
  "meta": { "request_id": "..." }
}

स्थिर संस्करण

संस्करण पते का ही भाग है, इसलिए हमारे बढ़ने के साथ भी आपका जोड़ चलता रहता है। उत्तरों में नए क्षेत्र आ सकते हैं; जो कुछ आपका कोड तोड़ सकता है, वह केवल नए संस्करण में आता है।

https://YOUR_HOST/v1/astro/...
Api-Version: 1          (optional request header)
X-Api-Version: 1.0.0    (every answer)

फलादेश भंडार

जिन योजनाओं में यह शामिल है, उनमें आप हमारा पूरा जाँचा हुआ फलादेश भंडार खंड दर खंड और पृष्ठ दर पृष्ठ, हर भाषा में और बिना किसी कटौती के पढ़ सकते हैं, ताकि अपने अनुभव स्वयं बना सकें।

GET /v1/astro/content/sections?lang=ta
GET /v1/astro/content/blocks?section=yogas&lang=ta&limit=100
GET /v1/astro/content/blocks?section=yogas&lang=ta&cursor=NEXT_CURSOR

कृत्रिम बुद्धि का वर्णन, ठोस आधार पर

कृत्रिम बुद्धि वाली रिपोर्टें केवल गणना की गई कुंडली और जाँचे हुए फलादेशों से लिखी जाती हैं, फिर आप तक पहुँचने से पहले लिपि और भाव के लिए जाँची जाती हैं। साझेदार हमारे मॉडल उपयोग कर सकते हैं, या जहाँ योजना अनुमति दे वहाँ अपने प्रदाता की कुंजी ला सकते हैं।

मशीन से पढ़ा जाने वाला विवरण

पूरा विवरण डाउनलोड करें और अपनी पसंद की प्रोग्रामिंग भाषा में क्लाइंट बनाएँ, या जिस उपकरण का आप पहले से उपयोग करते हैं उसमें हर सेवा बिंदु को देखें।

GET https://YOUR_HOST/v1/astro/openapi.json
GET https://YOUR_HOST/v1/astro/catalog