/api/astro/western/composite/1 кредитКомпозитная карта
Карта отношений по средним точкам, которую толкуют как самостоятельную сущность. Синастрия сравнивает две карты, а композит их ОБЪЕДИНЯЕТ: каждое тело ставится в среднюю точку между его положениями в картах двух людей, и результат толкуется как карта самих отношений, а не одного из партнёров. Средние точки берутся по короткой дуге — так принято, и это НЕ то же самое, что среднее двух чисел: для пары 350 и 10 градусов композит даёт 0, а не 180. Для каждого тела указаны обе исходные долготы, так что среднюю точку можно проверить. У композита нет скорости и ретроградности: это не момент времени, и ничто в нём не движется. А вот аспекты между телами композита ИМЕЮТ смысл и возвращаются.
https://api.occultapi.com/api/astro/western/composite/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| date_time | string (date-time) | обязательный | Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC, и может вернуть результат за предыдущий день со статусом 200. '2026-09-01T06:00:00Z' и '2026-09-01 06:00:00' — разные моменты, и ответы для них будут разными. |
| partner_date_time | string (date-time) | обязательный | |
| ayanamsa | string | необязательный | TROPICAL (по умолчанию) или название аянамши, например LAHIRI, KRISHNAMURTI, RAMAN или FAGAN_BRADLEY, без учёта регистра. При сидерической аянамше из каждой возвращаемой долготы вычитается её значение на соответствующий момент. |
| include_asteroid_lilith | boolean | необязательный | Добавить астероид (1181) Лилит под именем "asteroid_lilith" после остальных тел. Это другое тело, не Чёрная Луна Лилит. |
| include_lilith | boolean | необязательный | Добавить Чёрную Луну Лилит (средний лунный апогей) как тело с именем "lilith", после остальных тел. |
| keys | array | необязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. |
| latitude | number (double) | необязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. |
| longitude | number (double) | необязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. |
| orb_factor | number (double) | необязательный | Масштабирует все орбисы аспектов. 0.5 уменьшает их вдвое, 2 — удваивает. min 0.1 · max 2 |
| partner_timezone_as_float | number (double) | необязательный | min -12 · max 14 |
| timezone_as_float | number (double) | необязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. min -12 · max 14 |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/western/composite/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-05-10T19:55:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"partner_date_time":"1988-11-23T07:15:00+05:30","partner_timezone_as_float":5.5,"orb_factor":1}'Ответ
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"zodiac\": \"tropical\", \"chart\": \"composite_midpoint\", \"orb_factor\": 1.0, \"planets\": [{\"name\": \"sun\", \"longitude\": 325.3295, \"from\": {\"person_a\": 49.66766, \"person_b\": 240.991341}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 25.3295, \"formatted\": \"25°19' Aquarius\"}, {\"name\": \"moon\", \"longitude\": 325.741456, \"from\": {\"person_a\": 238.259725, \"person_b\": 53.223187}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 25.7415, \"formatted\": \"25°44' Aquarius\"}, {\"name\": \"mercury\", \"longitude\": 317.866522, \"from\": {\"person_a\": 39.452338, \"person_b\": 236.280707}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 17.8665, \"formatted\": \"17°51' Aquarius\"}, {\"name\": \"venus\", \"longitude\": 288.321938, \"from\": {\"person_a\": 7.250368, \"person_b\": 209.393508}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 18.3219, \"formatted\": \"18°19' Capricorn\"}, {\"name\": \"mars\", \"longitude\": 354.304998, \"from\": {\"person_a\": 344.690843, \"person_b\": 3.919152}, \"sign\": \"Pisces\", \"sign_index\": 12, \"degree_in_sign\": 24.305, \"formatted\": \"24°18' Pisces\"}, {\"name\": \"jupiter\", \"longitude\": 79.84236, \"from\": {\"person_a\": 98.630274, \"person_b\": 61.054447}, \"sign\": \"Gemini\", \"sign_index\": 3, \"degree_in_sign\": 19.8424, \"formatted\": \"19°50' Gemini\"}, {\"name\": \"saturn\", \"longitude\": 283.210836, \"from\": {\"person_a\": 295.313114, \"person_b\": 271.108557}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 13.2108, \"formatted\": \"13°12' Capricorn\"}, {\"name\": \"uranus\", \"longitude\": 274.377978, \"from\": {\"person_a\": 279.296197, \"person_b\": 269.459759}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 4.378, \"formatted\": \"4°22' Capricorn\"}, {\"name\": \"neptune\", \"longitude\": 281.474487, \"from\": {\"person_a\": 284.419553, \"person_b\": 278.52942}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 11.4745, \"formatted\": \"11°28' Capricorn\"}, {\"name\": \"pluto\", \"longitude\": 224.774448, \"from\": {\"person_a\": 226.304012, \"person_b\": 223.244883}, \"sign\": \"Scorpio\", \"sign_index\": 8, \"degree_in_sign\": 14.7744, \"formatted\": \"14°46' Scorpio\"}, {\"name\": \"north_node\", \"longitude\": 325.694721, \"from\": {\"person_a\": 310.874753, \"person_b\": 340.514689}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 25.6947, \"formatted\": \"25°41' Aquarius\"}, {\"name\": \"chiron\", \"longitude\": 99.523745, \"from\": {\"person_a\": 102.832128, \"person_b\": 96.215362}, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 9.5237, \"formatted\": \"9°31' Cancer\"}], \"count\": 29, \"aspects\": [{\"from\": \"moon\", \"to\": \"north_node\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 0.0467, \"separation\": 0.0467}, {\"from\": \"sun\", \"to\": \"north_node\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 0.3652, \"separation\": 0.3652}, {\"from\": \"sun\", \"to\": \"moon\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 0.412, \"separation\": 0.412}, {\"from\": \"mercury\", \"to\": \"venus\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 0.4554, \"separation\": 29.5446}, {\"from\": \"sun\", \"to\": \"mars\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 1.0245, \"separation\": 28.9755}, {\"from\": \"mars\", \"to\": \"north_node\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 1.3897, \"separation\": 28.6103}, {\"from\": \"moon\", \"to\": \"mars\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 1.4365, \"separation\": 28.5635}, {\"from\": \"venus\", \"to\": \"jupiter\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 1.5204, \"separation\": 151.5204}, {\"from\": \"saturn\", \"to\": \"pluto\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 1.5636, \"separation\": 58.4364}, {\"from\": \"saturn\", \"to\": \"neptune\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 1.7363, \"separation\": 1.7363}, {\"from\": \"neptune\", \"to\": \"chiron\", \"aspect\": \"opposition\", \"exact_angle\": 180.0, \"orb\": 1.9507, \"separation\": 178.0493}, {\"from\": \"mercury\", \"to\": \"jupiter\", \"aspect\": \"trine\", \"exact_angle\": 120.0, \"orb\": 1.9758, \"separation\": 121.9758}, {\"from\": \"mercury\", \"to\": \"pluto\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 3.0921, \"separa"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.