/api/astro/house_lord_particular_house/1 кредитРозташування володаря дому (одна пара)
Володар дому несе справи свого дому туди, куди потрапляє, тож у класичних текстах є окреме твердження для кожного зі 144 поєднань — дванадцять володарів у дванадцяти місцях. Цей ендпоінт повертає твердження для однієї пари. У house вкажіть дім, володар якого вас цікавить, санскритською назвою бхави в написанні цього ендпоінта — lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya для домів із першого по дванадцятий, — а в number — дім, у якому він стоїть, від 1 до 12. Зверніть увагу: /api/astro/effect_house_lord_different_house/ охоплює те саме, але з іншим набором назв та іншим текстом; ці два ендпоінти не взаємозамінні. Карта не обчислюється, тож дата, час чи місце не надсилаються — спершу самостійно визначте, де стоїть володар. Невідома назва дому чи номер поза діапазоном повертає HTTP 200 з рядком 'Invalid key: …', а не статус помилки. Єдиний ключ — get_house_lord.
https://api.occultapi.com/api/astro/house_lord_particular_house/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| house | string | обов’язковий | lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyayaБхава, ВОЛОДАРЯ якої ви розміщуєте: lagna = 1-й... vyaya = 12-й. УВАГА: цей ендпоінт використовує ІНШИЙ набір назв, ніж /api/astro/effect_house_lord_different_house/ — тут 5-й/6-й/7-й/8-й/9-й — це 'putra', 'satru', 'yuvati', 'randhara' (зверніть увагу на додаткове 'a': randhAra) і 'dharma'. Переводиться в нижній регістр. Невідоме значення повертає 200 із "Invalid key: <x>". |
| keys | array | обов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. get_house_lordМасив рядків; доступний лише один ключ. |
| number | integer | обов’язковий | 123456789101112Ціле число 1-12 — дім, у якому стоїть володар. Значення поза діапазоном повертає 200 із "Invalid key: <n>". |
Доступні ключі (1)
Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.
| Ключ | Додаткові поля | Опис |
|---|---|---|
| get_house_lord | house, number | Класичні наслідки того, що володар одного дому стоїть в іншому: house — бхава, володарем якої він є, number — дім, у якому він стоїть. Повертає список коротких тверджень англійською, зазвичай від одного до трьох, напр. 'Blessed with paternal and maternal happiness'. Довідковий текст, прив’язаний до пари; з карти нічого не обчислюється. |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/house_lord_particular_house/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_house_lord"],"house":"lagna","number":4}'Відповідь
{
"data": {
"get_house_lord": [
"Blessed with paternal and maternal happiness",
"Gains many brothers, is charming, virtuous, and has a passionate nature"
]
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.