API de partes árabes

A partir de la fecha, hora, desfase UTC y coordenadas de nacimiento, el endpoint primero establece el Ascendente y las longitudes planetarias relevantes, y luego aplica la fórmula de cada suerte —característicamente el Ascendente más un planeta menos otro— para producir un punto zodiacal derivado. Calcula la lista completa de suertes clásicas: Fortuna, Espíritu, Eros y las demás transmitidas en la tradición helenística. De forma crucial, el cálculo es consciente de la secta: para un nacimiento diurno la Suerte de la Fortuna usa un orden de Sol y Luna, y para un nacimiento nocturno ese orden se invierte, con el Espíritu reflejándolo, de modo que las mismas posiciones planetarias arrojan suertes distintas según si el Sol está sobre o bajo el horizonte. La respuesta devuelve cada suerte bajo data.parts con su longitud calculada, lista para colocarse de vuelta en la carta por signo y casa. Estos puntos no son cuerpos sino grados sensibles, y el endpoint los trata como tales, dándote la ubicación sin inventar movimiento ni aspectos que no tienen.

curl -X POST https://api.astroway.info/v1/arabic-parts \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'

{
  "ok": true,
  "data": {
    "parts": [
      {
        "name": "Fortune",
        "longitude": 98.7,
        "sign": "Cancer"
      },
      {
        "name": "Spirit",
        "longitude": 222.1,
        "sign": "Scorpio"
      }
    ]
  }
}

Usa este endpoint cuando una lectura helenística o tradicional necesite las suertes como factores de carta de primera clase: un intérprete de técnica clásica, un informe que discuta la Fortuna y el Espíritu como significadores tópicos, o un renderizador de cartas que quiera dibujar las suertes junto a los planetas. Como la inversión por secta se maneja por ti, evitas el error más común en el cálculo manual de suertes, y las cartas nocturnas salen correctas sin casos especiales en tu propio código. Combínalo con la llamada natal-chart: toma las longitudes de las suertes devueltas aquí y asígnalas a casas usando las cúspides de tu carta, de modo que la Fortuna caiga en su lugar correcto. La salida es puramente posicional, lo que significa que puedes superponer tu propio tratamiento interpretativo de cada suerte —qué significa la Fortuna, qué gobierna Eros— sobre grados fiables y correctos por secta.

Las fórmulas de las suertes siguen la tradición helenística transmitida a través de fuentes como Sahl ibn Bishr y al-Bīrūnī, con el manejo de la secta diurna/nocturna alineado con la reconstrucción moderna de Robert Hand y el Project Hindsight. Las posiciones que alimentan las fórmulas provienen del motor WASM de Swiss Ephemeris (Astrodienst) en el zodíaco tropical, coincidiendo con los endpoints natales.