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

शास्त्रपरंपरेवर आधारलेले

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

तुमची किल्ली

प्रत्येक विनंतीसोबत तुमची किल्ली विनंतीच्या शीर्षात पाठवा. आम्ही किल्लीची फक्त एकमार्गी ठसा ठेवतो, म्हणून तुम्हाला दाखवलेली गुप्त किल्ली सुरक्षित ठेवा; ती कधी उघड झाली तर ती रद्द करा आणि तुमच्या नियंत्रण कक्षातून नवी किल्ली तयार करा.

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