API de partes árabes
As Partes Árabes, ou Lotes Helenísticos, são pontos calculados derivados por aritmética sobre o mapa em vez de lidos diretamente do céu. Este endpoint calcula a Parte da Fortuna, do Espírito, de Eros e as restantes a partir de fórmulas sobre o Ascendente e dois planetas, tratando da inversão entre nascimento diurno e noturno que a prática real dos Lotes exige.
API de partes árabes
A partir da data de nascimento, hora, desvio UTC e coordenadas, o endpoint estabelece primeiro o Ascendente e as longitudes planetárias relevantes e depois aplica a fórmula de cada Lote — caracteristicamente o Ascendente mais um planeta menos outro — para produzir um ponto zodiacal derivado. Calcula a lista completa de Lotes clássicos: Fortuna, Espírito, Eros e os outros transmitidos na tradição helenística. Crucialmente, o cálculo é sensível à seita: para um nascimento diurno, a Parte da Fortuna usa uma ordenação de Sol e Lua, e para um nascimento noturno essa ordenação inverte-se, com o Espírito a espelhá-la — pelo que as mesmas posições planetárias produzem Lotes diferentes consoante o Sol esteja acima ou abaixo do horizonte. A resposta devolve cada Lote em data.parts com a sua longitude calculada, pronta a ser recolocada no mapa por signo e casa. Estes pontos não são corpos, mas graus sensíveis, e o endpoint trata-os como tal, dando-lhe a localização sem inventar movimento ou aspetos que não têm.
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
}'{
"ok": true,
"data": {
"parts": [
{
"name": "Fortune",
"longitude": 98.7,
"sign": "Cancer"
},
{
"name": "Spirit",
"longitude": 222.1,
"sign": "Scorpio"
}
]
}
}Parâmetros
| name | type | Obrigatório | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sim | Birth date. |
| time | string (HH:MM:SS) | sim | Local clock time at birth. |
| timezoneOffset | number (hours) | sim | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | sim | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | sim | Birth-place longitude, decimal degrees (east positive). |
Quando usar
Use este endpoint quando uma leitura helenística ou tradicional precise dos Lotes como fatores de primeira ordem do mapa — um intérprete de técnica clássica, um relatório que discute Fortuna e Espírito como significadores tópicos, ou um renderizador de mapas que queira desenhar os Lotes junto aos planetas. Como a inversão de seita é tratada por si, evita o erro mais comum no cálculo manual dos Lotes, e os mapas noturnos saem corretos sem casos especiais no seu próprio código. Combine-o com a chamada natal-chart: tome as longitudes dos Lotes aqui devolvidas e atribua-as a casas usando as cúspides do seu mapa, para que a Fortuna caia no seu devido lugar. A saída é puramente posicional, o que significa que pode sobrepor o seu próprio tratamento interpretativo de cada Lote — o que a Fortuna significa, o que Eros governa — sobre graus fiáveis e corretos quanto à seita.
Notas
As fórmulas dos Lotes seguem a tradição helenística transmitida através de fontes como Sahl ibn Bishr e al-Bīrūnī, com o tratamento da seita diurna/noturna alinhado com a reconstrução moderna de Robert Hand e do Project Hindsight. As posições que alimentam as fórmulas provêm do motor WASM do Swiss Ephemeris (Astrodienst) no zodíaco tropical, coincidindo com os endpoints natais.
Experimente a API de Partes Árabes
Obtenha uma chave e faça a sua primeira chamada em menos de um minuto.