/api/astro/ashtakoota/1 кредитСовместимость по ашта-куте (гун-милан)
Ашта-кута — североиндийская система оценки совместимости невесты и жениха по восьми критериям, только по их накшатрам рождения. Каждый критерий оценивается в баллах: варна — до 1, васья — до 2, тара — до 3, йони — до 4, граха-майтри — до 5, гана — до 6, бхакут — до 7 и нади — до 8, всего максимум 36 баллов. Южноиндийская практика (порутам) задаёт почти те же вопросы, но на большинство из них отвечает «да» или «нет» и добавляет ещё четыре проверки: махендра, ведха, раджу и стри-диргха. Нужны всего четыре числа: накшатры невесты и жениха (1–27, от Ashwini до Revati) и пады, в которые они попадают (1–4). Время и место рождения не нужны. Если они у вас есть, лучше используйте /api/astro/horoscope-match/: он сам определит накшатру и вернёт более полный отчёт. Начните с ключа `compatibility_score`: он выполняет все проверки и возвращает их вместе с суммой. Два важных момента. Поле `method` принимается, но до расчёта не доходит, поэтому баллы всегда считаются по североиндийской системе; чтобы получить южноиндийский ответ «да/нет» по проверке, запросите её ключ с суффиксом `_south`. А каждая кута в северной форме возвращает список из двух элементов [балл, максимум], а не просто число.
https://api.occultapi.com/api/astro/ashtakoota/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| boy_nakshatra_number | integer | обязательный | |
| boy_paadham_number | integer | обязательный | |
| girl_nakshatra_number | integer | обязательный | |
| girl_paadham_number | integer | обязательный | |
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. raasi_from_nakshatra_padavarna_poruthamvasiya_poruthamvasiya_porutham_southdina_poruthamdina_porutham_southgana_poruthamgana_porutham_southyoni_poruthamyoni_porutham_southraasi_adhipathi_poruthamraasi_adhipathi_porutham_southМассив строк. Варианты `_south` возвращают южноиндийскую булеву форму того же порутама. |
| method | string | обязательный | NorthSouthВАЖНО: `method` объявлен обязательным, но никогда не передаётся в движок, поэтому что бы вы ни отправили, используется значение ашта-куты по умолчанию "North". Если бы значение передавалось, движок проверял бы без учёта регистра, есть ли в нём подстрока 'south': 'South'/'south'/'South Indian' выбирали бы южный метод, а всё остальное — северный. |
| nakshatra_number | integer | обязательный | |
| paadha_number | integer | обязательный | |
| use_astroyogi_method | boolean | обязательный |
Доступные ключи (25)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| compatibility_score | — | Все проверки сразу — плоским списком из 13 элементов в таком порядке: варна, васья, гана, дина, йони, граха-майтри, бхакут и нади как простые числа, затем сумма из 36, затем махендра, ведха, раджу и стри-диргха как булевы значения. Обратите внимание: первые восемь здесь — простые баллы, а не пары [балл, максимум], которые возвращают отдельные ключи, и порядок не совпадает с порядком баллов от 1 до 8. |
| dina_porutham | — | Дина, она же тара-кута, — отсчитывает накшатру жениха от накшатры невесты и по полученной категории тары судит о здоровье и благополучии. Максимум 3 балла; возвращает [балл, 3.0], где балл равен 0.0, 1.5 или 3.0. |
| dina_porutham_south | — | Южноиндийская форма дины: true, если счёт накшатр от жениха до невесты — один из двенадцати благоприятных (2, 4, 6, 8, 9, 11, 13, 15, 18, 20, 24, 26). Возвращает булево значение. |
| gana_porutham | — | Гана-кута сравнивает темпераменты партнёров — божественный, человеческий или демонический; максимум 6 баллов. Возвращает [балл, 6], где балл равен 0, 1, 5 или 6. |
| gana_porutham_south | — | Южноиндийская форма ганы: true, только если обе накшатры относятся к одной гане по южноиндийским спискам. Возвращает булево значение, поэтому частичное совпадение, которое в северной форме принесло бы 5 баллов, здесь даёт false. |
| mahendra_porutham | — | Махендра — одна из четырёх дополнительных южноиндийских проверок; касается потомства и прочности союза. Равно true, если счёт от накшатры невесты до накшатры жениха равен 4, 7, 10, 13, 16, 19, 22 или 25. Возвращает булево значение. |
| mahendra_porutham_south | — | Идентичен `mahendra_porutham`: южноиндийский вариант напрямую вызывает его, поэтому оба ключа возвращают одно и то же булево значение. Запрашивайте один из них, а не оба. |
| naadi_porutham | — | Нади-кута — проверка конституции. У неё наибольший вес, 8 баллов, и по традиции несовпадение по ней ничем не перекрыть. Возвращает [балл, 8], где балл равен 0 или 8. |
| naadi_porutham_south | — | Южноиндийская форма нади: true, если две накшатры относятся к разным нади. Возвращает булево значение, равносильное 8 баллам в северной форме. |
| raasi_adhipathi_porutham | — | Граха-майтри-кута — дружба между управителями двух лунных знаков; максимум 5 баллов. Возвращает [балл, 5.0], где балл равен 0, 0.5, 1, 3, 4 или 5. |
| raasi_adhipathi_porutham_south | — | Южноиндийская форма граха-майтри по отдельной таблице дружбы управителей. Возвращает целое число 0 или 1 — обратите внимание, это число, а не булево значение, как у большинства других ключей `_south`. |
| raasi_from_nakshatra_pada | nakshatra_number, paadha_number | Лунный знак, в который попадает данная четверть накшатры. Принимает `nakshatra_number` (1–27) и `paadha_number` (1–4) — обратите внимание, это отдельные поля запроса, не те, что для юноши и девушки, — и возвращает одно целое число 1–12, от Овна до Рыб. |
| raasi_porutham | — | Бхакут-кута оценивает расстояние между двумя лунными знаками; максимум 7 баллов. Возвращает [балл, 7], где балл равен либо 0, либо 7 — промежуточных значений нет. |
| raasi_porutham_south | — | Южноиндийская форма бхакута: true ровно тогда, когда северная форма дала бы полные 7 баллов. Возвращает булево значение. |
| rajju_porutham | — | Раджу сопоставляет каждой накшатре часть тела (голова, шея, живот, талия или ступня) и касается долголетия мужа. Возвращает булево значение: true, если обе накшатры относятся к одной группе раджу. |
| rajju_porutham_south | — | Южноиндийская форма раджу с более дробным восьмичастным делением: каждая часть тела делится на восходящую (аарога) и нисходящую (аварога) половины. Возвращает булево значение и может расходиться с `rajju_porutham`, потому что группы составлены иначе. |
| sthree_dheerga_porutham | — | Стри-диргха проверяет, достаточно ли далеко накшатра жениха опережает накшатру невесты, чтобы брак был долгим. Равно true, если счёт от накшатры невесты до накшатры жениха больше 15. Возвращает булево значение. |
| sthree_dheerga_porutham_south | — | Идентичен `sthree_dheerga_porutham`: то же правило «счёт больше 15», возвращается как булево значение. |
| varna_porutham | — | Варна-кута — проверка по касте, или духовному темпераменту; максимум 1 балл. Возвращает [балл, 1], где балл равен 0 или 1. |
| vasiya_porutham | use_astroyogi_method | Васья-кута показывает, насколько каждый партнёр тянется к другому и готов ему подчиняться; максимум 2 балла. Возвращает [балл, 2.0], где балл равен 0, 0.5, 1 или 2. Если передать `use_astroyogi_method` со значением true, используется альтернативная таблица с баллами 0, 1, 1.5 или 2. |
| vasiya_porutham_south | — | Южноиндийская форма васьи: просто true/false — входит ли лунный знак жениха в число знаков, которые притягивает знак невесты. Возвращает булево значение, а не пару [балл, максимум], как в северной форме. |
| vedha_porutham | — | Ведха — проверка на взаимно «пронзающие» накшатры. Равно true, если сумма номеров двух накшатр не равна 19, 28 или 37 — это неблагоприятные пары. Возвращает булево значение. |
| vedha_porutham_south | — | Идентичен `vedha_porutham`: южноиндийский вариант напрямую вызывает его, поэтому оба ключа возвращают одно и то же булево значение. |
| yoni_porutham | — | Йони-кута — половая и инстинктивная совместимость по животным-символам двух накшатр; максимум 4 балла. Возвращает [балл, 4], где балл — целое число от 0 до 4. |
| yoni_porutham_south | — | Южноиндийская форма йони: true, если животные-символы не образуют известную враждебную пару. Возвращает булево значение. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/ashtakoota/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["raasi_from_nakshatra_pada"],"boy_nakshatra_number":5,"boy_paadham_number":3,"girl_nakshatra_number":12,"girl_paadham_number":2,"method":"North","nakshatra_number":0,"paadha_number":0,"use_astroyogi_method":true}'Ответ
{
"data": {
"raasi_from_nakshatra_pada": 1
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.