Cargando el Playground
curl -X POST https://api.occultapi.com/api/astro/sarvatobhadra/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'El tablero de nueve por nueve que se usa para valorar los tránsitos, con los grahas colocados en él y el vedha (perforación) ya calculado. Los veintiocho nakshatras (los veintisiete habituales más Abhijit) ocupan el anillo exterior en un orden fijo que empieza en Krittika y avanza en el sentido de las agujas del reloj, NO en el orden normal de los nakshatras. Las casillas interiores contienen los doce signos, los siete días de la semana y un conjunto de sílabas. Un graha situado en un nakshatra perfora la casilla que tiene enfrente, al otro lado del tablero. La cuadrícula 9×9 completa se devuelve junto con las posiciones, así que puedes dibujar el chakra en lugar de limitarte a leer un veredicto. Cada casilla indica qué contiene y si está en el anillo. Pasa `transit_date_time` para colocar los grahas en tránsito en el mismo tablero: para eso sirve realmente el chakra. `hits_natal` enumera entonces los grahas en tránsito cuyo vedha cae sobre un nakshatra ocupado en tu carta natal. `rule` indica qué regla de vedha se aplicó. Solo se usa el vedha posicional: la fila superior perfora la inferior en la misma columna, y la columna izquierda perfora la derecha en la misma fila. Las escuelas que añaden vedha diagonal, de tithi o de vaara darán resultados distintos; por eso, en lugar de elegir una sin avisar, cada respuesta indica la regla aplicada. Si la grafía de un nakshatra no se puede asignar a ninguna casilla, se devuelve en `unplaced` en lugar de descartarse, de modo que ningún graha desaparece del tablero sin aviso.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| date_time | string (date-time) | obligatorio | El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas. |
| latitude | number (double) | obligatorio | Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -90 · max 90 |
| longitude | number (double) | obligatorio | Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180 |
| ayanamsa | string | opcional | |
| timezone_as_float | number (double) | opcional | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14 |
| transit_date_time | string (date-time) | opcional | Opcional. Si lo envías, el chakra muestra también los grahas en tránsito de ese momento junto a los natales; para eso se interpreta realmente el chakra. |