ବିଷୟବସ୍ତୁକୁ ଯାଆନ୍ତୁ

ଜ୍ୟୋତିଷ ଏପିଆଇ

ଗୋଟିଏ ଚାବିରେ ଆପଣଙ୍କ ଆପ୍ ଜ୍ୟୋତିଷର ସମ୍ପୂର୍ଣ୍ଣ ଗଣନା ପାଏ: ପଞ୍ଜିକା, ଜନ୍ମ କୁଣ୍ଡଳୀ, ବିବାହ ମେଳକ, ଦଶା, ଦୋଷ, ରାଶିଫଳ, ସଂଖ୍ୟା ଶାସ୍ତ୍ର, ବାସ୍ତୁ ଓ ସମ୍ପୂର୍ଣ୍ଣ ବିବରଣୀ। ପ୍ରତ୍ୟେକ ଉତ୍ତର ଆପଣ ପଠାଉଥିବା ତାରିଖ, ସମୟ ଓ ସ୍ଥାନ ପାଇଁ ସେହି କ୍ଷଣରେ ଗଣନା କରି, ଆପଣଙ୍କ ପାଠକଙ୍କ ନିଜ ଭାଷାରେ ଲେଖାଯାଏ।

ଶାସ୍ତ୍ରୀୟ ପରମ୍ପରାରେ ମୂଳ ଥିବା

କୁଣ୍ଡଳୀ ଓ ଫଳାଦେଶ ପାରାଶରୀ ପରମ୍ପରାକୁ ଅନୁସରଣ କରେ, ଯେପରି ବୃହତ୍ ପାରାଶର ହୋରା ଶାସ୍ତ୍ର, ଫଳଦୀପିକା, ସାରାବଳୀ ଓ ଜାତକ ପାରିଜାତରେ ଶିଖାଯାଇଛି। ବିବାହ ମେଳକରେ ଉତ୍ତର ଭାରତର ଅଷ୍ଟକୂଟ ଗୁଣ ମିଳନ ଓ ଦକ୍ଷିଣ ଭାରତର ଦଶ ପୋରୁତ୍ତମ ପଦ୍ଧତି ଦୁହେଁ ଅଛି, ଏବଂ ବାସ୍ତୁ ଷୋହଳ ଦିଗ ଅଞ୍ଚଳ ଓ ବାସ୍ତୁ ପୁରୁଷ ମଣ୍ଡଳର ପଞ୍ଚଚାଳିଶ ଦେବତାଙ୍କୁ ଅନୁସରଣ କରେ।

ଆପଣଙ୍କ ଚାବି

ପ୍ରତ୍ୟେକ ଅନୁରୋଧ ସହିତ ଆପଣଙ୍କ ଚାବିକୁ ଅନୁରୋଧର ଶୀର୍ଷରେ ପଠାନ୍ତୁ। ଆମେ ଚାବିର କେବଳ ଏକମୁଖୀ ଛାପ ରଖୁ, ତେଣୁ ଆପଣଙ୍କୁ ଦେଖାଯାଇଥିବା ଗୁପ୍ତ ଚାବିକୁ ସୁରକ୍ଷିତ ରଖନ୍ତୁ; ଯଦି ତାହା କେବେ ବାହାରିଯାଏ, ତାକୁ ବାତିଲ କରି ଆପଣଙ୍କ ନିୟନ୍ତ୍ରଣ ଫଳକରୁ ନୂଆ ଚାବି ତିଆରି କରନ୍ତୁ।

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
/v1/astro/prediction/biorhythm/v1/astro/prediction/daily-moon/v1/astro/prediction/daily-sun/v1/astro/prediction/daily-nakshatra/v1/astro/prediction/day-number/v1/astro/prediction/monthly/v1/astro/prediction/numerology/v1/astro/prediction/weekly-moon/v1/astro/prediction/weekly-sun/v1/astro/prediction/yearly/v1/astro/horoscope/planet-details/v1/astro/horoscope/planet-report/v1/astro/horoscope/planetary-aspects/v1/astro/horoscope/planets-in-houses/v1/astro/horoscope/divisional-charts/v1/astro/horoscope/personal-characteristics/v1/astro/horoscope/ai-12-month-prediction/v1/astro/horoscope/ascendant-report/v1/astro/horoscope/ashtakvarga/v1/astro/horoscope/binnashtakvarga/v1/astro/horoscope/chart-image/v1/astro/horoscope/ashtakvarga-chart-image/v1/astro/horoscope/western-planets/v1/astro/matching/aggregate-match/v1/astro/matching/ashtakoot/v1/astro/matching/ashtakoot-with-astro-details/v1/astro/matching/bulk-nakshatra-match/v1/astro/matching/bulk-ashtakoot/v1/astro/matching/bulk-dashakoot/v1/astro/matching/bulk-western-match/v1/astro/matching/dashakoot/v1/astro/matching/dashakoot-with-astro-details/v1/astro/matching/south-match/v1/astro/matching/nakshatra-match/v1/astro/matching/papasamaya/v1/astro/matching/papasamaya-match/v1/astro/matching/quick-matcher/v1/astro/matching/rajju-vedha-details/v1/astro/matching/western-match/v1/astro/panchang/choghadiya-muhurta/v1/astro/panchang/hora-muhurta/v1/astro/panchang/monthly-panchang/v1/astro/panchang/moon-calendar/v1/astro/panchang/moon-phase/v1/astro/panchang/moonrise/v1/astro/panchang/moonset/v1/astro/panchang/panchang/v1/astro/panchang/retrogrades/v1/astro/panchang/solarnoon/v1/astro/panchang/sunrise/v1/astro/panchang/sunset/v1/astro/panchang/transit-dates/v1/astro/panchang/festivals/v1/astro/dosha/kaalsarp-dosh/v1/astro/dosha/mangal-dosh/v1/astro/dosha/manglik-dosh/v1/astro/dosha/pitra-dosh/v1/astro/dashas/antar-dasha/v1/astro/dashas/char-dasha-current/v1/astro/dashas/char-dasha-main/v1/astro/dashas/char-dasha-sub/v1/astro/dashas/current-mahadasha/v1/astro/dashas/current-mahadasha-full/v1/astro/dashas/maha-dasha/v1/astro/dashas/maha-dasha-predictions/v1/astro/dashas/paryantar-dasha/v1/astro/dashas/specific-sub-dasha/v1/astro/dashas/yogini-dasha-main/v1/astro/dashas/yogini-dasha-sub/v1/astro/extended/arutha-padas/v1/astro/extended/current-sade-sati/v1/astro/extended/extended-kundli-details/v1/astro/extended/find-ascendant/v1/astro/extended/find-moon-sign/v1/astro/extended/find-sun-sign/v1/astro/extended/friendship/v1/astro/extended/gem-suggestion/v1/astro/extended/jaimini-karakas/v1/astro/extended/kp-houses/v1/astro/extended/kp-planets/v1/astro/extended/numero-table/v1/astro/extended/rudraksh-suggestion/v1/astro/extended/sade-sati-table/v1/astro/extended/shad-bala/v1/astro/extended/varshapal-details/v1/astro/extended/varshapal-month-chart/v1/astro/extended/varshapal-year-chart/v1/astro/extended/yoga-list/v1/astro/utilities/gem-details/v1/astro/utilities/geo-search/v1/astro/utilities/geo-search-advanced/v1/astro/utilities/nakshatra-vastu-details/v1/astro/utilities/radical-number-details/v1/astro/report/natal/v1/astro/report/year-ahead/v1/astro/report/life-periods/v1/astro/report/match/v1/astro/report/muhurta/v1/astro/report/transit/v1/astro/report/gems/v1/astro/report/numerology/v1/astro/report/annual/v1/astro/report/career/v1/astro/report/vastu/v1/astro/report/civil/v1/astro/ai_report/natal/v1/astro/ai_report/year-ahead/v1/astro/ai_report/life-periods/v1/astro/ai_report/match/v1/astro/ai_report/muhurta/v1/astro/ai_report/transit/v1/astro/ai_report/gems/v1/astro/ai_report/numerology/v1/astro/ai_report/annual/v1/astro/ai_report/career/v1/astro/ai_report/vastu/v1/astro/ai_report/civil/v1/astro/text/avakhada/v1/astro/text/chara/v1/astro/text/gemstones/v1/astro/text/house-analysis/v1/astro/text/lagna-report/v1/astro/text/life-domains/v1/astro/text/match-porutham/v1/astro/text/match-verdict/v1/astro/text/monthly-transits/v1/astro/text/numerology-full/v1/astro/text/other-dashas/v1/astro/text/planet-cards/v1/astro/text/planet-deep-dive/v1/astro/text/remedies/v1/astro/text/rudraksha/v1/astro/text/sahams/v1/astro/text/shadbala/v1/astro/text/slow-transits/v1/astro/text/strengths-challenges/v1/astro/text/tarabala-chandrabala/v1/astro/text/varga-readings/v1/astro/text/varshaphal/v1/astro/text/vimshottari-narrative/v1/astro/text/yogas/v1/astro/text/yogini/v1/astro/content/sections/v1/astro/content/blocks/v1/astro/vastu/zones

ତିନି ଆକାରରେ ସମ୍ପୂର୍ଣ୍ଣ ବିବରଣୀ

ଆମର ଯାଞ୍ଚ ହୋଇଥିବା ନିୟମ ଆଧାରିତ ଫଳାଦେଶ ଭଣ୍ଡାରରୁ ତିଆରି ସମ୍ପୂର୍ଣ୍ଣ ବିବରଣୀ ମାଗନ୍ତୁ, କିମ୍ବା ସେହି କୁଣ୍ଡଳୀ ତଥ୍ୟ ଉପରେ କୃତ୍ରିମ ବୁଦ୍ଧିମତ୍ତା ଲେଖିଥିବା ବର୍ଣ୍ଣନା। ପ୍ରତ୍ୟେକ ବିବରଣୀ ଗଠିତ ପାଠ୍ୟ, ସଜ୍ଜିତ ଦଲିଲ, କଣ୍ଠରେ କୁହାଯାଇଥିବା ଫଳାଦେଶ କିମ୍ବା କୁଣ୍ଡଳୀ ଚଳଚ୍ଚିତ୍ର ରୂପେ ମିଳେ, ଏବଂ ପ୍ରତ୍ୟେକ ଛୋଟ, ମଧ୍ୟମ କିମ୍ବା ବିସ୍ତୃତ ଆକାରରେ।

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