જ્યોતિષ એપીઆઈ

શાસ્ત્રીય પરંપરામાં મૂળ ધરાવતું

કુંડળી અને ફળાદેશ પારાશરી પરંપરાને અનુસરે છે, જેમ બૃહત્ પારાશર હોરા શાસ્ત્ર, ફળદીપિકા, સારાવલી અને જાતક પારિજાતમાં શીખવ્યું છે. લગ્ન મેળાપકમાં ઉત્તર ભારતનો અષ્ટકૂટ ગુણ મેળાપ અને દક્ષિણ ભારતની દસ પોરુત્તમ પદ્ધતિ બંને ઉપલબ્ધ છે, અને વાસ્તુ સોળ દિશા વિભાગો તથા વાસ્તુપુરુષ મંડળના પિસ્તાળીસ દેવતાઓને અનુસરે છે.

તમારી ચાવી

દરેક વિનંતી સાથે તમારી ચાવી વિનંતીના મથાળામાં મોકલો. અમે ચાવીની માત્ર એકતરફી છાપ રાખીએ છીએ, તેથી તમને બતાવેલી ગુપ્ત ચાવી સુરક્ષિત રાખો; જો તે ક્યારેય જાહેર થઈ જાય તો તેને રદ કરીને તમારા નિયંત્રણ પટલમાંથી નવી ચાવી બનાવો.

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