জ্যোতিষ এপিআই

শাস্ত্রীয় ঐতিহ্যে প্রোথিত

কুণ্ডলী ও ফলাদেশ পরাশরী ঐতিহ্য অনুসরণ করে, যেমন বৃহৎ পরাশর হোরা শাস্ত্র, ফলদীপিকা, সারাবলী ও জাতক পারিজাতে শেখানো হয়েছে। বিবাহের মিলে উত্তর ভারতের অষ্টকূট গুণ মিলন এবং দক্ষিণ ভারতের দশ পোরুত্তম পদ্ধতি দুটিই আছে, আর বাস্তু ষোলোটি দিক অঞ্চল ও বাস্তুপুরুষ মণ্ডলের পঁয়তাল্লিশ দেবতাকে অনুসরণ করে।

আপনার চাবি

প্রতিটি অনুরোধের সঙ্গে আপনার চাবি অনুরোধের শিরোনামে পাঠান। আমরা চাবির কেবল একমুখী ছাপ রাখি, তাই আপনাকে দেখানো গোপন চাবিটি নিরাপদে রাখুন; কখনো ফাঁস হলে সেটি বাতিল করে আপনার নিয়ন্ত্রণ ফলক থেকে নতুন চাবি তৈরি করুন।

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