Cargando el Playground
curl -X POST https://api.occultapi.com/api/astro/attributes/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'Un cajón de sastre con doce pequeños datos de la carta en una sola llamada; cosas que, de otro modo, te obligarían a hacer una docena de solicitudes. Siempre calcula los doce, envíes lo que envíes. Incluye el nakshatra y el pada de una longitud eclíptica, el número y el planeta regente de un nakshatra a partir de su nombre, el señor Hadda (término egipcio) de una longitud dentro de un signo, el señor Kakshya y el número de Kakshya, el signo zodiacal de una longitud, qué planetas están combustos en el momento indicado, el ángulo de fase de la Luna, la próxima fecha de una fase lunar elegida, los cuatro momentos de ingreso estacional de un año y una posición de carta divisional calculada a partir de una longitud. Solo `date_time` es obligatorio; todo lo demás tiene un valor por defecto (longitude 0, name 'Ashwini', zodiac 'Aries', lord 'saturn', target_phase 0 para la luna nueva, limitdays 30, el año en curso, chart_factor 1 para la carta Rashi), así que una llamada mínima con solo `date_time` y `longitude` ya te da los planetas combustos, la fase lunar, el nakshatra y el signo. Dos peculiaridades: `lord` se compara distinguiendo mayúsculas y minúsculas con unos datos que guardan Mercurio con inicial mayúscula, así que 'mercury' devuelve null sin aviso, mientras que 'Mercury' devuelve un número; y los campos `when` y `nakshatras` de la solicitud se aceptan, pero nunca se leen.
| 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. Restricción de FORMATO, no un enum. DRF DateTimeField: solo ISO-8601 (formatos de entrada por defecto de DRF), p. ej., "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" o "2026-09-01 06:00:00" (sin zona horaria = se toma como UTC). |
| chart_factor | integer | opcional | Factor de carta divisional para dasavarga_from_longitude (1=Rashi, 9=Navamsa, etc.). |
| limitdays | integer | opcional | Intervalo de búsqueda, en días, para search_moon_phase. |
| longitude | number (double) | opcional | 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 |
| lord | string | opcional | Señor planetario que usa get_kakshya_number. saturnjupitermarssunvenusMercurymoonascendantCoincidencia exacta que DISTINGUE mayúsculas y minúsculas. Los propios datos son incoherentes: siete entradas están en minúsculas, pero Mercurio se guarda con inicial mayúscula como 'Mercury', así que 'mercury' devuelve null sin aviso mientras que 'Mercury' devuelve 6. Un valor que no coincide devuelve null sin error. Valor por defecto: 'saturn'. |
| nakshatras | string | opcional | |
| name | string | opcional | Nombre del nakshatra que usa get_nakshatra_details. AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishthaNombre del nakshatra para el resultado `nakshatra_details`. No distingue mayúsculas y minúsculas, y se eliminan los espacios al principio y al final. Se reconocen tanto las grafías modernas (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada) como las transliteraciones más antiguas del motor (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra). Se acepta 'Abhijit' (esquema de 28 nakshatras). Valor por defecto: 'Ashwini'. |
| target_phase | integer | opcional | Fase lunar que se busca: 0=nueva, 1=cuarto creciente, 2=llena, 3=cuarto menguante. |
| when | string | opcional | |
| year | integer | opcional | Año de nacimiento como número, p. ej., 1990. Cuatro dígitos. |
| zodiac | string | opcional | Signo zodiacal que usa get_hadda_lord. AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces |