/api/astro/astottaramsa/1 créditoAstottaramsa (D108)
El astottaramsa, la división número ciento ocho, que se obtiene a partir del navamsa. Como en D81, el motor también tiene una versión por división directa, accesible con /api/astro/chart/ y `chart_name: "AstottaramsaChart"`, y las dos no coinciden. CON UNOS 17' POR DIVISIÓN, la precaución sobre la hora de nacimiento es aún mayor. Devuelve la misma estructura plana que /api/astro/planet-positions/: los planetas como lista en el orden tradicional, cada uno con `name`, longitud, signo, nakshatra, pada y casa, además del ascendente y el ayanamsa aplicado. La ruta fija la carta, así que un `chart_name` en el cuerpo se ignora en lugar de respetarse: este endpoint no puede devolver nada más que esta división.
https://api.occultapi.com/api/astro/astottaramsa/Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| chart_name | string | obligatorio | |
| datetime | 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. Significa lo mismo que date_time; otros endpoints simplemente le dan ese otro nombre. |
| 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 -89.9 · max 89.9 |
| 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 |
| aberration | boolean | opcional | |
| apply_correction | boolean | opcional | |
| ascendant_pos | string | opcional | cuspstartend |
| ayanamsa | string | opcional | |
| background_color | string | opcional | Color hexadecimal del fondo del SVG. |
| chart_style | string | opcional | Estilo del diagrama cuando render='svg'. 'north' es el diseño en rombo, con las casas fijas y los signos rotando; 'south' es la cuadrícula de signos fijos, con las casas rotando. northsouth |
| correction_deg | integer | opcional | min 0 |
| correction_direction | string | opcional | addsubtract |
| correction_min | integer | opcional | min 0 · max 59 |
| correction_sec | integer | opcional | min 0 · max 59 |
| extended_bodies | array | opcional | Grupos de cuerpos que incluir: 'asteroids', 'planetary_moons', 'fictitious_bodies'. |
| label_style | string | opcional | Cómo se rotulan los planetas: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) o 'symbol' (☉, ☽, ...). englishsanskritsymbol |
| line_color | string | opcional | Color hexadecimal de las líneas de la cuadrícula de la carta. |
| notation | string | opcional | astrologicaldegree |
| nutation | boolean | opcional | |
| planet_color | string | opcional | Color hexadecimal de las etiquetas de los planetas, p. ej., '#111827'. Valor por defecto: el color propio del tema. |
| rahu | string | opcional | Tipo de nodo que se incluye. 'true' devuelve solo los nodos verdaderos; 'mean', solo los nodos medios, y 'both', ambos. truemeanboth |
| refraction | boolean | opcional | |
| render | string | opcional | Ponlo en 'svg' para recibir también un diagrama renderizado de la carta (consulta chart_style) y la geometría en la que se basa. Si no lo envías, la respuesta no cambia. nonesvg |
| show_degrees | boolean | opcional | Muestra el grado de cada cuerpo dentro de su signo junto a su etiqueta. |
| sign_color | string | opcional | Color hexadecimal de los números y abreviaturas de los signos. |
| svg_size | integer | opcional | Ancho y alto del viewBox cuadrado del SVG, en píxeles. min 100 · max 2000 |
| theme | string | opcional | lightdark |
| true_mean | string | opcional | TrueMean |
| use_28_nakshatras | boolean | opcional |
Ejemplo de solicitud
Este ejemplo aún no está verificado
Los nombres y tipos de campo vienen de la definición de la API y son correctos. Pero este cuerpo concreto no devolvió una respuesta correcta la última vez que lo probamos; puede que le falte un valor que no podemos deducir. Úsalo como punto de partida, no como un comando listo para usar.
curl -X POST https://api.occultapi.com/api/astro/astottaramsa/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"chart_name":"string","datetime":"2026-09-01 06:00:00","latitude":26.9124,"longitude":75.7873,"ascendant_pos":"cusp","chart_style":"north","correction_direction":"add","label_style":"english","notation":"astrological","rahu":"true","render":"none","theme":"light","true_mean":"True"}'Respuesta
Aún no hay una respuesta de ejemplo verificada para este endpoint. La solicitud de arriba se genera a partir de la definición de la API y es correcta; solo publicamos ejemplos de respuesta cuando los hemos comprobado con una llamada real.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.