PanditOne CloudPlataforma de desarrollador

Documentos API públicos

Integra cartas, informes, compatibilidad y herramientas de práctica.

Estos documentos describen la superficie API del proveedor. Utilice la consola del espacio de trabajo después de iniciar sesión para crear claves, inspeccionar el uso y administrar los límites.

URL básica

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

Autentíquese con una clave API del espacio de trabajo mediante la autenticación de portador o X-API-Key.

Pase referencias de clientes a través de external_customer_id e idempotency_key.

Mantenga los precios, el pago, el consentimiento y el flujo de entrega de sus propios clientes.

Autenticación

Envíe el secreto de API del espacio de trabajo como token de portador o como clave X-API. Los secretos se muestran una vez cuando se crean en la consola del espacio de trabajo.

Authorization: Bearer $PANDITONE_API_KEY

X-API-Key: $PANDITONE_API_KEY

Inicio rápido

Esta llamada devuelve datos del gráfico sin crear una extracción de informe. Utilice el punto final del informe completo cuando necesite un enlace de informe guardado.

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"
}'

Puntos finales

POST

Calcular gráfico

chart_calculation

/developer/api/v1/charts/calculate

Devuelva datos deterministas del gráfico Kundli a partir de los detalles de nacimiento enviados por el proveedor.

POST

Generar informe Kundli completo

full_kundli_report

/developer/api/v1/reports/full

Cree un registro de informe guardado, un enlace de informe seguro y una referencia de descarga/PDF.

POST

Partido dos Kundlis

compatibility_match

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

Relacione dos perfiles de nacimiento con Ashtakoot, revisión de dosha, sincronización de dasha y orientación práctica.

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.

Carga útil de nacimiento

Utilice esta forma para el cálculo de gráficos y la generación de informes completos. Se recomiendan las coordenadas porque reducen la ambigüedad en la coincidencia de lugares y la selección de zona horaria.

{
  "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"
}

Coincidencia de Kundli

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

Envíe dos perfiles de nacimiento para recibir puntuación determinista de Ashtakoot, dosha y evidencia de mitigación, factores de relación, D1 y contexto de relación-varga, referencias de dasha, recomendaciones prácticas, advertencias y uso de cuotas actuales.

Requerido para cada socio

full_name: · Nombre para mostrar, entre 1 y 180 caracteres.
date_of_birth: · Fecha ISO en formato AAAA-MM-DD.
birth_place_text: · Ciudad o lugar de nacimiento legible por humanos.

Campos de precisión

time_of_birth: · HH:MM:SS; omitir cuando se desconozca.
time_accuracy: · exacto, aproximado o desconocido. Establecer desconocido al omitir la hora.
latitud / longitud / zona horaria: · Recomendado para evitar ambigüedades de lugar y zona horaria.

external_customer_id y idempotency_key son referencias de conciliación opcionales. No coloque secretos ni datos personales innecesarios en ninguno de los campos.

{
  "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"
}'

Punto final heredado: POST /developer/api/v1/compatibility/match sigue estando disponible para integraciones existentes, pero está en desuso. Las nuevas integraciones deben utilizar la ruta de coincidencia Kundli anterior. Ambos consumen el compatibility_match unidad de cuota.

Herramientas de práctica

Estos endpoints usan la misma clave API del espacio de trabajo, seguimiento de solicitudes, configuración regional y controles de cuota que el cálculo de cartas. El uso de Muhurta se cuenta por cada día evaluado; las demás herramientas consumen una unidad de cálculo por solicitud.

PanchangPOST /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"
}'

Buscador de MuhurtaPOST /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"}'

Planificador de PujaPOST /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"}'

TránsitosPOST /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"}'

Respuesta coincidente

uso score_summary para obtener una descripción general compacta y conservar las secciones de evidencia al presentar el resultado. Una partitura clásica no es una aprobación o un rechazo independientes.

ashtakoot

Ocho controles de Guna Milan, puntuaciones individuales, total de 36, porcentaje y veredicto.

dosha_analysis

Evidencia, gravedad, detalles de mitigación y advertencias de Nadi, Bhakoot, Manglik o Kuja.

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

La cuota de compatibilidad_match consumida, la asignación restante y la clave del período de facturación.

{
  "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"
  }
}

Lugares

conjunto locale en la solicitud. Alias de idiomas como hi Se aceptan, aunque se prefieren los códigos locales canónicos.

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

Forma de respuesta

Las respuestas incluyen una identificación de solicitud, una identificación de proveedor, una identificación de espacio de trabajo, una configuración regional, una versión del motor, detalles de cálculo, una carga útil de resultados, advertencias y la cuota de uso relevante.

{
  "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"
  }
}

Errores y límites

400

Solicitud no válida o entrada coincidente que no se puede calcular.

401

Missing, malformed, revoked, or unknown API key.

402

Workspace API access is not active.

422

Error de validación para la forma de la carga útil, fecha, hora, ubicación o código de plan.

429

Límite de tarifa o cuota mensual excedida para la unidad solicitada.

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.

Postura de datos y privacidad

The API is intended for provider platforms that already manage their own customer relationship and consent.
Las llamadas de informes completos crean registros de informes guardados para que el flujo de clientes pueda volver a abrir el enlace generado.
Almacene sus propias referencias de clientes en external_customer_id en lugar de enviar datos de cuentas internas innecesarios.
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.

Operaciones de API privadas

Administre claves, límites y uso desde la consola del espacio de trabajo.

Los documentos son públicos para que los proveedores puedan evaluar la integración. Las claves API, las suscripciones activas, el uso de cuotas y el historial de solicitudes permanecen detrás del inicio de sesión en el espacio de trabajo.

Ver docs API Consola abierta