POST/api/astro/attributes/1 crédito

Atributos de la carta

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.

https://api.occultapi.com/api/astro/attributes/

Probar solicitud

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/json

Campos de la solicitud

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. `saturnjupitermarssunvenusMercurymoonascendant` Coincidencia 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. `AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishtha` Nombre 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`

Ejemplo de solicitud

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

Respuesta

{
  "data": {
    "nakshatra_pada": [
      "Aardra",
      3
    ],
    "nakshatra_details": [
      1,
      "Ketu"
    ],
    "hadda_lord": null,
    "kakshya_lord": "venus",
    "kakshya_number": 1,
    "zodiac_name": "Gemini",
    "combust_planets": {
      "Mars": false,
      "Mercury": false,
      "Venus": false,
      "Jupiter": false,
      "Saturn": false
    },
    "moon_phase": 250.14160858923307,
    "search_moon_phase": "2024-12-01T06:22:06Z",
    "seasons": {
      "spring_equinox": "0001-03-20T21:39:01Z",
      "summer_solstice": "0001-06-22T20:51:18Z",
      "autumnal_equinox": "0001-09-23T07:34:54Z",
      "winter_solstice": "0001-12-21T00:14:00Z"
    },
    "dasavarga_from_longitude": {
      "constellation": 2,
      "longitude": 16.125
    },
    "get_nakshatra_name": "Aardra"
  },
  "message": "successful",
  "is_error": false
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.

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.