/api/astro/rashi_in_house_insights/1 кредитТлумачення знака в домі
Заздалегідь написані тлумачення знака зодіаку в певному домі карти: Овен у другому домі, Рак у сьомому тощо — усі 144 поєднання. Кожне описує, якими стають справи дому під впливом цього знака. Це лише довідник, жодних розрахунків. Ключ один — `get_rashi_in_house`: він приймає `rashi` як назву знака, а `house` — не номером, а санскритською назвою: `lagna`, `dhana`, `sahaja`, `sukha`, `putra`, `satru`, `yuvati`, `randhra`, `bhagya`, `karma`, `labha`, `vyaya` для домів з першого по дванадцятий. Значення — список коротких речень, зазвичай від чотирьох до шести; кожне речення — окреме твердження, тож його можна показати окремим рядком. Назва поза допустимим набором повертає рядок `Invalid key` з HTTP 200, а не помилку.
https://api.occultapi.com/api/astro/rashi_in_house_insights/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| house | string | обов’язковий | lagnadhanasahajasukhaputrasatruyuvatirandhrabhagyakarmalabhavyayaПопри назву поля, це НЕ число, а санскритська назва бхави: доми 1–12 у наведеному порядку. Невідоме значення повертає "Invalid key: <x>" з HTTP 200. |
| keys | array | обов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. |
| rashi | string | обов’язковий | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesАнглійські назви знаків, а не санскритські. |
Доступні ключі (1)
Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.
| Ключ | Додаткові поля | Опис |
|---|---|---|
| get_rashi_in_house | house, rashi | Класичне тлумачення знака `rashi` у домі `house`, де дім задано не номером, а санскритською назвою (від `lagna` до `vyaya`). Повертає список коротких речень, зазвичай від чотирьох до шести, і кожне з них — окреме твердження. |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/rashi_in_house_insights/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_rashi_in_house"],"house":"dhana","rashi":"aries"}'Відповідь
{
"data": {
"get_rashi_in_house": [
"Gains wealth through righteous deeds.",
"Possesses a friendly and virtuous nature.",
"Blessed with male children.",
"Endowed with cattle and livestock.",
"Fond of the company of scholars."
]
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.