علم نجوم اے پی آئی

کلاسیکی روایت میں جڑیں رکھنے والا

زائچے اور پیش گوئیاں پراشری روایت کی پیروی کرتے ہیں، جیسا کہ برہت پراشر ہورا شاستر، پھل دیپیکا، ساراولی اور جاتک پاریجات میں سکھایا گیا ہے۔ شادی کے ملان میں شمالی ہند کا اشٹ کوٹ گن ملان اور جنوبی ہند کا دس پورتم طریقہ دونوں موجود ہیں، اور واستو سولہ سمتی حصوں اور واستو پرش منڈل کے پینتالیس دیوتاؤں پر چلتا ہے۔

آپ کی کنجی

ہر درخواست کے ساتھ اپنی کنجی درخواست کے سرنامے میں بھیجیں۔ ہم کنجی کا صرف یک طرفہ نشان رکھتے ہیں، اس لیے جو خفیہ کنجی آپ کو دکھائی گئی تھی اسے محفوظ رکھیں؛ اگر وہ کبھی ظاہر ہو جائے تو اسے منسوخ کر کے اپنے کنٹرول پینل سے نئی کنجی بنا لیں۔

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