AstroWay/api v2.200.11 · it
tutti i sistemi sono operativi
// astrology api · POST /v1/arabic-parts

API delle Parti Arabiche

Le Parti Arabiche, o Parti Ellenistiche, sono punti calcolati derivati da operazioni aritmetiche sul grafico anziché letti direttamente dal cielo. Questo endpoint calcola la Parte della Fortuna, dello Spirito, di Eros e le altre da formule sul Ascendente e due pianeti, gestendo l'inversione per nascita diurna e notturna che la pratica reale delle Parti richiede.

Endpoint
POST /v1/arabic-parts
Cost
20 credits
Latency
~65 ms
Tier
Tier 2
// 01 / What it computes

API delle Parti Arabiche

Dalla data, ora, offset UTC e coordinate di nascita, l'endpoint stabilisce prima l'Ascendente e le longitudini planetarie rilevanti, poi applica la formula di ciascuna Parte - tipicamente l'Ascendente più un pianeta meno un altro - per produrre un punto zodiacale derivato. Calcola l'intera serie di Parti classiche: Fortuna, Spirito, Eros e le altre tramandate nella tradizione Ellenistica. Crucialmente il calcolo tiene conto della sezione: per una nascita diurna la Parte della Fortuna usa un ordine specifico di Sole e Luna, e per una nascita notturna quell'ordine si inverte, con lo Spirito che lo riflette - quindi le stesse posizioni planetarie producono Parti diverse a seconda che il Sole sia sopra o sotto l'orizzonte. La risposta restituisce ciascuna Parte sotto data.parts con la sua longitudine calcolata, pronta ad essere inserita di nuovo nel grafico per segno e casa. Questi punti non sono corpi celesti ma gradi sensibili, e l'endpoint li tratta come tali, fornendoti la posizione senza inventare movimenti o aspetti che non possiede.

// 02 / Live request

POST/v1/arabic-parts

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
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "parts": [
      {
        "name": "Fortune",
        "longitude": 98.7,
        "sign": "Cancer"
      },
      {
        "name": "Spirit",
        "longitude": 222.1,
        "sign": "Scorpio"
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
// 04 / When to use it

When to use it

Usa questo endpoint quando una lettura Ellenistica o tradizionale ha bisogno delle Parti come fattori di primo livello nel grafico - un interprete con tecniche classiche, un report che discute Fortuna e Spirito come significatori tematici, o un renderer di grafici che vuole disegnare le Parti insieme ai pianeti. Poiché l'inversione di sezione è gestita per te, eviti l'errore più comune nel calcolo manuale delle Parti, e i grafici notturni risultano corretti senza casi speciali nel tuo codice. Accoppialo con la chiamata al grafico natale: prendi le longitudini delle Parti restituite qui e assegnale alle case usando i cuspi del tuo grafico, così Fortuna atterra nel suo posto corretto. L'output è puramente posizionale, il che significa che puoi applicare il tuo trattamento interpretativo di ciascuna Parte - cosa significa Fortuna, cosa governa Eros - su gradi affidabili e corretti per sezione.

// 05 / Notes

Notes

Le formule delle Parti seguono la tradizione Ellenistica tramandata attraverso fonti come Sahl ibn Bishr e al-Bīrūnī, con la gestione della sezione giorno/notta allineata alla ricostruzione moderna di Robert Hand e Project Hindsight. Le posizioni che alimentano le formule provengono dal motore Swiss Ephemeris (Astrodienst) nello zodiaco tropicale, corrispondendo agli endpoint natali.

Try the Parti Arabiche API

Grab a key and make your first call in under a minute.

99.9% SLA · piani a pagamento · 30d stato →