API арабських часток
Арабські частки, або елліністичні жереби, — це обчислені точки, що виводяться арифметикою над картою, а не зчитуються прямо з неба. Цей ендпоінт обчислює Жереб Фортуни, Духу, Ероса та інші за формулами над Асцендентом і двома планетами, опрацьовуючи розворот для денного й нічного народження, якого вимагає справжня практика жеребів.
API арабських часток
За датою народження, часом, зсувом UTC та координатами ендпоінт спершу встановлює Асцендент і потрібні довготи планет, а потім застосовує формулу кожного жереба — характерно Асцендент плюс одна планета мінус інша — щоб дати виведену зодіакальну точку. Він обчислює повний набір класичних жеребів: Фортуну, Дух, Ероса та інші, передані елліністичною традицією. Принципово, що обчислення враховує секту: для денного народження Жереб Фортуни використовує один порядок Сонця й Місяця, а для нічного цей порядок розвертається, і Дух дзеркалить його — тож ті самі положення планет дають різні жереби залежно від того, Сонце над чи під горизонтом. Відповідь повертає кожен жереб у data.parts із його обчисленою довготою, готовий до розміщення назад у карту за знаком і домом. Ці точки — не тіла, а чутливі градуси, і ендпоінт ставиться до них саме так, даючи розташування, не вигадуючи руху чи аспектів, яких вони не мають.
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"
}
]
}
}Параметри
| name | type | Обов’язк. | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | так | Birth date. |
| time | string (HH:MM:SS) | так | Local clock time at birth. |
| timezoneOffset | number (hours) | так | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | так | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | так | Birth-place longitude, decimal degrees (east positive). |
Коли використовувати
Звертайтеся до цього ендпоінта, коли елліністичному чи традиційному читанню потрібні жереби як повноцінні фактори карти — для інтерпретатора класичних технік, звіту, що обговорює Фортуну й Дух як тематичних сигніфікаторів, чи рендерера карти, що хоче малювати жереби поруч із планетами. Оскільки розворот за сектою опрацьовано за вас, ви уникаєте найпоширенішої помилки ручного обчислення жеребів, і нічні карти виходять правильними без особливих випадків у вашому коді. Поєднуйте з викликом natal-chart: візьміть повернуті тут довготи жеребів і призначте їх домам за куспідами вашої карти, щоб Фортуна потрапила на належне місце. Вивід суто позиційний, а отже ви можете накласти власне тлумачення кожного жереба — що означає Фортуна, чим керує Ерос — поверх надійних, секто-коректних градусів.
Нотатки
Формули жеребів слідують елліністичній традиції, переданій через джерела на кшталт Сахля ібн Бішра та аль-Біруні, із опрацюванням денної/нічної секти за сучасною реконструкцією Роберта Генда та Project Hindsight. Положення, що живлять формули, беруться з рушія Swiss Ephemeris (Astrodienst) на WASM у тропічному зодіаку, збігаючись із натальними ендпоінтами.
Спробуйте Арабські частки API
Отримайте ключ і зробіть перший виклик за хвилину.