പൊതു API ഡോക്‌സ്

ചാർട്ടുകൾ, റിപ്പോർട്ടുകൾ, പൊരുത്തം, പ്രാക്ടീസ് ഉപകരണങ്ങൾ എന്നിവ സംയോജിപ്പിക്കുക.

ഈ ഡോക്‌സ് ദാതാവിൻ്റെ API ഉപരിതലത്തെ വിവരിക്കുന്നു. കീകൾ സൃഷ്‌ടിക്കാനും ഉപയോഗം പരിശോധിക്കാനും പരിധികൾ നിയന്ത്രിക്കാനും സൈൻ ഇൻ ചെയ്‌തതിന് ശേഷം വർക്ക്‌സ്‌പെയ്‌സ് കൺസോൾ ഉപയോഗിക്കുക.

അടിസ്ഥാന URL

https://jyotishone-api-obf6jvpdqq-uc.a.run.app/api/v1

Bearer auth അല്ലെങ്കിൽ X-API-Key ഉപയോഗിച്ച് വർക്ക്‌സ്‌പെയ്‌സ് API കീ ഉപയോഗിച്ച് പ്രാമാണീകരിക്കുക.

External_customer_id, idempotency_key എന്നിവയിലൂടെ ഉപഭോക്തൃ റഫറൻസുകൾ കൈമാറുക.

നിങ്ങളുടെ സ്വന്തം ഉപഭോക്തൃ വിലനിർണ്ണയം, ചെക്ക്ഔട്ട്, സമ്മതം, ഡെലിവറി ഫ്ലോ എന്നിവ നിലനിർത്തുക.

പ്രാമാണീകരണം

വർക്ക്‌സ്‌പെയ്‌സ് API രഹസ്യം ഒരു ബിയറർ ടോക്കണായി അല്ലെങ്കിൽ 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: · YYYY-MM-DD ഫോർമാറ്റിലുള്ള ISO തീയതി.
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

ഉപയോഗിച്ച compatibility_match ക്വാട്ട, ശേഷിക്കുന്ന അലവൻസ്, ബില്ലിംഗ് കാലയളവ് കീ.

{
  "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 കീകൾ, സജീവ സബ്‌സ്‌ക്രിപ്‌ഷനുകൾ, ക്വാട്ട ഉപയോഗം, അഭ്യർത്ഥന ചരിത്രം എന്നിവ വർക്ക്‌സ്‌പേസ് സൈൻ-ഇൻ പിന്നിൽ തുടരും.

API ഡോക്‌സ് വായിക്കുക കൺസോൾ തുറക്കുക