జ్యోతిష ఏపీఐ

శాస్త్ర సంప్రదాయంలో పాతుకుపోయినది

జాతకాలు, ఫలితాలు పరాశర సంప్రదాయాన్ని అనుసరిస్తాయి, బృహత్ పరాశర హోరా శాస్త్రం, ఫలదీపిక, సారావళి, జాతక పారిజాతం బోధించినట్లే. వివాహ పొంతనలో దక్షిణ భారత పది పొరుత్తాల పద్ధతి, ఉత్తర భారత అష్టకూట గుణ పద్ధతి రెండూ ఉన్నాయి; వాస్తు పదహారు దిశా భాగాలను, వాస్తు పురుష మండలంలోని నలభై ఐదు దేవతలను అనుసరిస్తుంది.

మీ తాళంచెవి

ప్రతి అభ్యర్థనతో మీ తాళంచెవిని అభ్యర్థన శీర్షికలో పంపండి. తాళంచెవి యొక్క ఒకవైపు ముద్రను మాత్రమే మేము ఉంచుతాము, కాబట్టి మీకు చూపిన రహస్య తాళంచెవిని భద్రంగా ఉంచండి; అది ఎప్పుడైనా బయటపడితే దాన్ని రద్దు చేసి మీ నియంత్రణ పలకం నుండి కొత్తది సృష్టించండి.

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