বিকাশকারী API

পাবলিক API ডক্স

চার্ট, রিপোর্ট, মিল এবং প্র্যাকটিস টুল একীভূত করুন।

এই ডক্স প্রদানকারী API পৃষ্ঠ বর্ণনা. কী তৈরি করতে, ব্যবহার পরিদর্শন করতে এবং সীমা পরিচালনা করতে সাইন-ইন করার পরে ওয়ার্কস্পেস কনসোল ব্যবহার করুন৷

বেস URL

https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1
Bearer auth বা X-API-কী ব্যবহার করে একটি ওয়ার্কস্পেস API কী দিয়ে প্রমাণীকরণ করুন।
external_customer_id এবং idempotency_key এর মাধ্যমে গ্রাহকের রেফারেন্স পাস করুন।
আপনার নিজস্ব গ্রাহক মূল্য, চেকআউট, সম্মতি, এবং বিতরণ প্রবাহ রাখুন।

প্রমাণীকরণ

ওয়ার্কস্পেস এপিআই সিক্রেট একটি বিয়ারার টোকেন বা X-API-কী হিসাবে পাঠান। ওয়ার্কস্পেস কনসোলে তৈরি করার সময় গোপনীয়তা একবার দেখানো হয়।

Authorization: Bearer $PANDITONE_API_KEY
X-API-Key: $PANDITONE_API_KEY

কুইকস্টার্ট

এই কল রিপোর্ট চেকআউট তৈরি না করেই চার্টের তথ্য প্রদান করে। আপনার একটি সংরক্ষিত প্রতিবেদন লিঙ্কের প্রয়োজন হলে সম্পূর্ণ প্রতিবেদনের শেষ পয়েন্ট ব্যবহার করুন।

curl -X POST https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1/developer/api/v1/charts/calculate \
  -H "Authorization: Bearer $PANDITONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "birth": {
    "full_name": "Customer Name",
    "date_of_birth": "1998-01-01",
    "time_of_birth": "02:02:00",
    "time_accuracy": "exact",
    "birth_place_text": "Mumbai, India",
    "latitude": "19.076000",
    "longitude": "72.877700",
    "timezone": "Asia/Kolkata"
  },
  "locale": "en-US",
  "report_type": "detailed_kundli",
  "external_customer_id": "cust_123",
  "idempotency_key": "order_123_chart"
}'

শেষবিন্দু

POST

চার্ট গণনা করুন

chart_calculation

/developer/api/v1/charts/calculate

প্রদানকারীর জমা দেওয়া জন্মের বিবরণ থেকে নির্ধারক কুন্ডলি চার্টের তথ্য ফেরত দিন।

POST

সম্পূর্ণ কুন্ডলি রিপোর্ট তৈরি করুন

full_kundli_report

/developer/api/v1/reports/full

একটি সংরক্ষিত রিপোর্ট রেকর্ড, সুরক্ষিত রিপোর্ট লিঙ্ক এবং PDF/ডাউনলোড রেফারেন্স তৈরি করুন।

POST

দুই কুন্ডলির মিল

compatibility_match

/developer/api/v1/kundli-matching/match

অষ্টকূট, দোষ পর্যালোচনা, দশা সময়, এবং ব্যবহারিক নির্দেশনার সাথে দুটি জন্মের প্রোফাইল মেলান।

POST

Calculate Panchang

chart_calculation

/developer/api/v1/tools/panchang

Return the local Panchang for a date, time, coordinates, and timezone.

POST

Find Muhurta Candidates

chart_calculation per evaluated day

/developer/api/v1/tools/muhurta/find

Compare transparent Panchang planning signals across a date range for practitioner review.

POST

Build Puja Plan

chart_calculation

/developer/api/v1/tools/puja-planner

Create an operational ceremony checklist and structured intake questions.

POST

Draft Sankalpa

chart_calculation

/developer/api/v1/tools/sankalpa

Create a reviewable Sankalpa intake draft from devotee, ceremony, purpose, date, and place.

POST

Calculate Transits

chart_calculation

/developer/api/v1/tools/transits

Calculate transits for a natal chart as of a requested date.

বার্থ পেলোড

চার্ট গণনা এবং সম্পূর্ণ প্রতিবেদন তৈরির জন্য এই আকারটি ব্যবহার করুন। স্থানাঙ্কগুলি সুপারিশ করা হয় কারণ তারা স্থানের মিল এবং সময় অঞ্চল নির্বাচনের ক্ষেত্রে অস্পষ্টতা হ্রাস করে৷

{
  "birth": {
    "full_name": "Customer Name",
    "date_of_birth": "1998-01-01",
    "time_of_birth": "02:02:00",
    "time_accuracy": "exact",
    "birth_place_text": "Mumbai, India",
    "latitude": "19.076000",
    "longitude": "72.877700",
    "timezone": "Asia/Kolkata"
  },
  "locale": "en-US",
  "report_type": "detailed_kundli",
  "external_customer_id": "cust_123",
  "idempotency_key": "order_123_chart"
}

কুন্ডলি ম্যাচিং

POST /developer/api/v1/kundli-matching/match

নির্ধারক অষ্টকূট স্কোরিং, দোষ এবং প্রশমন প্রমাণ, সম্পর্ক বিষয়ক, D1 এবং সম্পর্ক-ভার্গ প্রসঙ্গ, দশা রেফারেন্স, ব্যবহারিক সুপারিশ, সতর্কতা, এবং বর্তমান কোটা ব্যবহার পেতে দুটি জন্ম প্রোফাইল পাঠান।

প্রতিটি অংশীদার জন্য প্রয়োজনীয়

full_name
· প্রদর্শনের নাম, 1-180 অক্ষর।
date_of_birth
· ISO তারিখ YYYY-MM-DD ফর্ম্যাটে।
birth_place_text
· মানুষের পাঠযোগ্য জন্ম শহর বা স্থান।

নির্ভুলতা ক্ষেত্র

time_of_birth
· HH:MM:SS; অজানা হলে বাদ দিন।
time_accuracy
· সঠিক, আনুমানিক বা অজানা। সময় বাদ দেওয়ার সময় অজানা সেট করুন।
অক্ষাংশ / দ্রাঘিমাংশ / সময় অঞ্চল
· স্থান এবং সময় অঞ্চলের অস্পষ্টতা এড়াতে সুপারিশ করা হয়।

external_customer_id এবং idempotency_key ঐচ্ছিক পুনর্মিলন রেফারেন্স. উভয় ক্ষেত্রেই গোপন বা অপ্রয়োজনীয় ব্যক্তিগত তথ্য রাখবেন না।

{
  "partner_a": {
    "full_name": "Partner A",
    "date_of_birth": "1998-01-01",
    "time_of_birth": "02:02:00",
    "time_accuracy": "exact",
    "birth_place_text": "Mumbai, India",
    "latitude": "19.076000",
    "longitude": "72.877700",
    "timezone": "Asia/Kolkata"
  },
  "partner_b": {
    "full_name": "Partner B",
    "date_of_birth": "1996-09-01",
    "time_of_birth": "20:38:00",
    "time_accuracy": "exact",
    "birth_place_text": "New York, United States",
    "latitude": "40.712800",
    "longitude": "-74.006000",
    "timezone": "America/New_York"
  },
  "locale": "en-US",
  "external_customer_id": "match_123",
  "idempotency_key": "match_123_v1"
}
curl -X POST https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1/developer/api/v1/kundli-matching/match \
  -H "Authorization: Bearer $PANDITONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "partner_a": {
    "full_name": "Partner A",
    "date_of_birth": "1998-01-01",
    "time_of_birth": "02:02:00",
    "time_accuracy": "exact",
    "birth_place_text": "Mumbai, India",
    "latitude": "19.076000",
    "longitude": "72.877700",
    "timezone": "Asia/Kolkata"
  },
  "partner_b": {
    "full_name": "Partner B",
    "date_of_birth": "1996-09-01",
    "time_of_birth": "20:38:00",
    "time_accuracy": "exact",
    "birth_place_text": "New York, United States",
    "latitude": "40.712800",
    "longitude": "-74.006000",
    "timezone": "America/New_York"
  },
  "locale": "en-US",
  "external_customer_id": "match_123",
  "idempotency_key": "match_123_v1"
}'
উত্তরাধিকার শেষ বিন্দু: POST /developer/api/v1/compatibility/match বিদ্যমান ইন্টিগ্রেশনের জন্য উপলব্ধ থাকে কিন্তু অবহেলিত হয়। নতুন ইন্টিগ্রেশনের জন্য উপরের কুন্ডলি ম্যাচিং পাথ ব্যবহার করা উচিত। উভয়ই গ্রাস করে compatibility_match কোটা ইউনিট।

অনুশীলনের সরঞ্জাম

এই এন্ডপয়েন্টগুলো চার্ট গণনার মতো একই ওয়ার্কস্পেস API কী, অনুরোধ ট্র্যাকিং, লোকেল ও কোটা নিয়ন্ত্রণ ব্যবহার করে। Muhurta-তে প্রতিটি মূল্যায়িত দিন গণনা হয়; অন্য টুল প্রতি অনুরোধে একটি চার্ট-গণনা ইউনিট ব্যবহার করে।

পঞ্জিকাPOST /developer/api/v1/tools/panchang

Calculate local tithi, vara, nakshatra, yoga, karana, and supporting calendar data.

curl -X POST https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1/developer/api/v1/tools/panchang \
  -H "Authorization: Bearer $PANDITONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-08",
  "local_time": "09:00:00",
  "location": {
    "place_text": "Toronto, Canada",
    "latitude": "43.6532",
    "longitude": "-79.3832",
    "timezone": "America/Toronto"
  },
  "locale": "en-US",
  "idempotency_key": "toronto-panchang-2026-10-08"
}'
মুহূর্ত অনুসন্ধানPOST /developer/api/v1/tools/muhurta/find

Compare planning signals across a date range for practitioner review.

curl -X POST https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1/developer/api/v1/tools/muhurta/find \
  -H "Authorization: Bearer $PANDITONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purpose":"Wedding ceremony","start_date":"2026-11-01","end_date":"2026-11-07","preferred_local_time":"09:00:00","location":{"place_text":"Toronto, Canada","latitude":"43.6532","longitude":"-79.3832","timezone":"America/Toronto"},"locale":"en-US"}'
পূজা পরিকল্পনাকারীPOST /developer/api/v1/tools/puja-planner

Build an editable ceremony checklist and structured intake plan.

curl -X POST https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1/developer/api/v1/tools/puja-planner \
  -H "Authorization: Bearer $PANDITONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ceremony":"Ganapati Puja","ceremony_date":"2026-11-01","attendee_count":25,"locale":"en-US"}'
SankalpaPOST /developer/api/v1/tools/sankalpa

Create a practitioner-review intake draft with gotra, tradition, purpose, date, and place.

curl -X POST https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1/developer/api/v1/tools/sankalpa \
  -H "Authorization: Bearer $PANDITONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"devotee_name":"Customer Name","gotra":"Bharadvaja","gotra_status":"provided","family_members":"Partner and children","sampradaya":"Family tradition","nakshatra":"Rohini","rashi":"Vrishabha","purpose":"family wellbeing","ceremony":"Ganapati Puja","ceremony_date":"2026-11-01","ceremony_time":"09:00:00","practitioner_instructions":"Confirm family pronunciation","location":{"place_text":"Toronto, Canada","latitude":"43.6532","longitude":"-79.3832","timezone":"America/Toronto"},"locale":"en-US"}'
গোচরPOST /developer/api/v1/tools/transits

Calculate current planetary positions against a natal chart for a requested date.

curl -X POST https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1/developer/api/v1/tools/transits \
  -H "Authorization: Bearer $PANDITONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"full_name":"Customer Name","date_of_birth":"1990-01-01","time_of_birth":"09:00:00","time_accuracy":"exact","birth_place_text":"Toronto, Canada","latitude":"43.6532","longitude":"-79.3832","timezone":"America/Toronto"},"as_of_date":"2026-10-08","locale":"en-US"}'

মিল প্রতিক্রিয়া

ব্যবহার করুন score_summary একটি কম্প্যাক্ট ওভারভিউ জন্য এবং ফলাফল উপস্থাপন করার সময় প্রমাণ বিভাগগুলি বজায় রাখুন। একটি ক্লাসিক্যাল স্কোর একটি স্বতন্ত্র অনুমোদন বা প্রত্যাখ্যান নয়।

ashtakoot

আট গুনা মিলান চেক, ব্যক্তিগত স্কোর, মোট 36 এর মধ্যে, শতাংশ, এবং রায়।

dosha_analysis

নদী, ভাকূট, মাঙ্গলিক বা কুজ প্রমাণ, তীব্রতা, প্রশমনের বিবরণ, এবং সতর্কতা।

relationship_factors

Chart-based factors beyond the classical score, including communication and partnership context.

recommendations

Prioritized, practical follow-up guidance derived from the calculated evidence.

pundit_reference

Moon, house, varga, dasha, placement, lordship, and Vedic-aspect reference data.

usage

সামঞ্জস্য_ম্যাচ কোটা খরচ, অবশিষ্ট ভাতা, এবং বিলিং সময়কাল কী।

{
  "request_id": "req_...",
  "provider": "panditone-developer-api",
  "tenant_id": "workspace_...",
  "locale": "en-US",
  "match": {
    "request_id": "match_...",
    "provider": "local-deterministic",
    "locale": "en-US",
    "matching_engine_version": "compatibility-match-0.2.0",
    "methodology": {
      "zodiac": "sidereal",
      "ayanamsa": "lahiri",
      "house_system": "whole-sign",
      "matching_system": "Ashtakoot Guna Milan with separate dosha and mitigation evidence"
    },
    "partners": { "partner_a": {}, "partner_b": {} },
    "score_summary": {
      "overall_band": "strong",
      "classical_score": 27.5,
      "max_score": 36,
      "percentage": 76.4
    },
    "ashtakoot": {
      "system": "Ashtakoot Guna Milan",
      "total_score": 27.5,
      "max_score": 36,
      "percentage": 76.4,
      "verdict": "strong",
      "checks": []
    },
    "dosha_analysis": {
      "flags": [],
      "manglik": {},
      "overall": "clear"
    },
    "relationship_factors": [],
    "recommendations": [],
    "pundit_reference": {
      "moon_reference": {},
      "ashtakoot_table": [],
      "key_placements": {},
      "partnership_houses": {},
      "varga_reference": {},
      "relationship_varga_interpretations": {},
      "dasha_reference": {},
      "vedic_aspects": {}
    },
    "warnings": [],
    "disclaimer": "This compatibility match is a deterministic cultural and spiritual Jyotish reading."
  },
  "usage": {
    "unit": "compatibility_match",
    "used": 4,
    "limit": 100,
    "remaining": 96,
    "period_key": "2026-08"
  }
}

লোকেল

সেট locale অনুরোধে ভাষার উপনাম যেমন hi গৃহীত হয়, যখন ক্যানোনিকাল লোকেল কোড পছন্দ করা হয়।

en-USes-EShi-INhi-Latnbn-INmr-INgu-INta-INte-INkn-INml-INpa-INne-NP

প্রতিক্রিয়া আকৃতি

প্রতিক্রিয়াগুলির মধ্যে একটি অনুরোধ আইডি, প্রদানকারী আইডি, ওয়ার্কস্পেস আইডি, লোকেল, ইঞ্জিন সংস্করণ, গণনার বিবরণ, ফলাফলের পেলোড, সতর্কতা এবং প্রাসঙ্গিক ব্যবহারের কোটা অন্তর্ভুক্ত রয়েছে।

{
  "request_id": "req_...",
  "provider": "panditone-developer-api",
  "tenant_id": "workspace_...",
  "locale": "en-US",
  "engine_version": "vedic-engine-...",
  "calculation_config": {
    "ayanamsa": "Lahiri",
    "house_system": "whole_sign"
  },
  "chart": {
    "birth_profile": {},
    "chart_summary": {},
    "planetary_positions": []
  },
  "warnings": [],
  "usage": {
    "unit": "chart_calculation",
    "used": 18,
    "limit": 1000,
    "remaining": 982,
    "period_key": "2026-07"
  }
}

ত্রুটি এবং সীমা

400

অবৈধ অনুরোধ বা মিলিত ইনপুট যা গণনা করা যাবে না।

401

Missing, malformed, revoked, or unknown API key.

402

Workspace API access is not active.

422

পেলোড আকৃতি, তারিখ, সময়, লোকেল বা প্ল্যান কোডের জন্য বৈধতা ত্রুটি৷

429

অনুরোধকৃত ইউনিটের জন্য হার সীমা বা মাসিক কোটা অতিক্রম করেছে।

5xx

Provider or engine error. Retry only according to your own duplicate-request safeguards; a supplied reference key does not by itself guarantee response replay.

ডেটা এবং গোপনীয়তার ভঙ্গি

  • The API is intended for provider platforms that already manage their own customer relationship and consent.
  • সম্পূর্ণ রিপোর্ট কলগুলি সংরক্ষিত রিপোর্ট রেকর্ড তৈরি করে যাতে জেনারেট করা লিঙ্কটি গ্রাহক প্রবাহ দ্বারা পুনরায় খোলা যায়।
  • অপ্রয়োজনীয় অভ্যন্তরীণ অ্যাকাউন্ট ডেটা পাঠানোর পরিবর্তে external_customer_id-এ আপনার নিজস্ব গ্রাহকের রেফারেন্স সংরক্ষণ করুন।
  • Do not use API output as medical, legal, financial, psychological, or safety advice.
  • Keep API keys server-side. Never expose a workspace API key in mobile app binaries or browser JavaScript.

ব্যক্তিগত API অপারেশন

ওয়ার্কস্পেস কনসোল থেকে কী, সীমা এবং ব্যবহার পরিচালনা করুন।

নথিগুলি সর্বজনীন তাই প্রদানকারীরা একীকরণের মূল্যায়ন করতে পারে৷ API কী, সক্রিয় সদস্যতা, কোটা ব্যবহার, এবং অনুরোধের ইতিহাস ওয়ার্কস্পেস সাইন-ইন করার পিছনে থাকে।

Developer API Docs | PanditOne Cloud