સાર્વજનિક 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-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 અને સંબંધ-વર્ગ સંદર્ભ, દશા સંદર્ભો, વ્યવહારુ ભલામણો, ચેતવણીઓ અને વર્તમાન ક્વોટા વપરાશ મેળવવા માટે બે જન્મ પ્રોફાઇલ્સ મોકલો.

દરેક ભાગીદાર માટે જરૂરી છે

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

સુસંગતતા_મેચ ક્વોટાનો વપરાશ, બાકી ભથ્થું અને બિલિંગ અવધિ કી.

{
  "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 દસ્તાવેજો વાંચો કન્સોલ ખોલો