பொது API ஆவணங்கள்

ஜாதகங்கள், அறிக்கைகள், பொருத்தம் மற்றும் பயிற்சி கருவிகளை ஒருங்கிணைக்கவும்.

இந்த ஆவணங்கள் வழங்குநர் API மேற்பரப்பை விவரிக்கின்றன. உள்நுழைந்த பிறகு பணியிட கன்சோலைப் பயன்படுத்தி விசைகளை உருவாக்கவும், பயன்பாட்டை ஆய்வு செய்யவும் மற்றும் வரம்புகளை நிர்வகிக்கவும்.

அடிப்படை URL

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

Bearer auth அல்லது X-API-Key ஐப் பயன்படுத்தி பணியிட API விசையுடன் அங்கீகரிக்கவும்.

வாடிக்கையாளர் குறிப்புகளை external_customer_id மற்றும் idempotency_key மூலம் அனுப்பவும்.

உங்கள் சொந்த வாடிக்கையாளர் விலை, செக் அவுட், ஒப்புதல் மற்றும் டெலிவரி ஓட்டத்தை வைத்திருங்கள்.

டாக்ஸ் வரைபடம்

தனிப்பட்ட பணியகம்

முக்கிய உருவாக்கம், திரும்பப் பெறுதல், தற்போதைய பயன்பாடு மற்றும் ஒதுக்கீடு தெரிவுநிலை ஆகியவற்றிற்கு அங்கீகரிக்கப்பட்ட பணியிட கன்சோலைப் பயன்படுத்தவும்.

கன்சோலைத் திற

அங்கீகாரம்

பணியிட ஏபிஐ ரகசியத்தை பியர் டோக்கனாக அல்லது எக்ஸ்-ஏபிஐ-விசையாக அனுப்பவும். பணியிட கன்சோலில் உருவாக்கும்போது ரகசியங்கள் ஒருமுறை காட்டப்படும்.

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 மற்றும் உறவு-வர்கா சூழல், dasha குறிப்புகள், நடைமுறை பரிந்துரைகள், எச்சரிக்கைகள் மற்றும் தற்போதைய ஒதுக்கீட்டு பயன்பாடு ஆகியவற்றைப் பெற இரண்டு பிறப்பு சுயவிவரங்களை அனுப்பவும்.

ஒவ்வொரு கூட்டாளிக்கும் தேவை

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.
முழு அறிக்கை அழைப்புகள் சேமிக்கப்பட்ட அறிக்கை பதிவுகளை உருவாக்குகின்றன, அதனால் உருவாக்கப்பட்ட இணைப்பை வாடிக்கையாளர் ஓட்டத்தால் மீண்டும் திறக்க முடியும்.
தேவையற்ற அகக் கணக்குத் தரவை அனுப்புவதற்குப் பதிலாக வெளிப்புற_கஸ்டமர்_ஐடியில் உங்கள் சொந்த வாடிக்கையாளர் குறிப்புகளைச் சேமிக்கவும்.
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 ஆவணங்களைப் படிக்கவும்கன்சோலைத் திற