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

शास्त्रपरम्परायां प्रतिष्ठितम्

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

भवतः कुञ्चिका

प्रत्येकेन अनुरोधेन सह स्वकुञ्चिकां अनुरोधशीर्षे प्रेषयतु। वयं कुञ्चिकायाः केवलम् एकमार्गिं मुद्राम् एव रक्षामः, अतः या गुप्तकुञ्चिका भवते दर्शिता तां सुरक्षिते स्थाने स्थापयतु; यदि सा कदापि प्रकटिता भवेत् तर्हि तां निरस्य स्वनियन्त्रणपटलात् नूतनां कुञ्चिकां सृजतु।

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