ஜோதிட ஏபிஐ

சாஸ்திர மரபில் வேரூன்றியது

ஜாதகங்களும் பலன்களும் பராசர மரபைப் பின்பற்றுகின்றன, பிருஹத் பராசர ஹோரா சாஸ்திரம், பலதீபிகை, சாராவளி, ஜாதக பாரிஜாதம் ஆகியவை கற்பிப்பது போலவே. திருமணப் பொருத்தத்தில் தென்னிந்தியப் பத்துப் பொருத்த முறையும் வட இந்திய அஷ்டகூட குண முறையும் உள்ளன; வாஸ்து பதினாறு திசைப் பகுதிகளையும் வாஸ்து புருஷ மண்டலத்தின் நாற்பத்தைந்து தேவதைகளையும் பின்பற்றுகிறது.

உங்கள் சாவி

ஒவ்வொரு கோரிக்கையுடனும் உங்கள் சாவியைக் கோரிக்கைத் தலைப்பில் அனுப்புங்கள். சாவியின் ஒருவழி அடையாளத்தை மட்டுமே நாங்கள் வைத்திருக்கிறோம், எனவே உங்களுக்குக் காட்டப்பட்ட ரகசியச் சாவியைப் பாதுகாப்பாக வையுங்கள்; அது எப்போதாவது வெளியானால், அதை ரத்து செய்து உங்கள் கட்டுப்பாட்டுப் பலகையிலிருந்து புதிய சாவியை உருவாக்குங்கள்.

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