POST/api/astro/planet_transit_over_house/1 кредит

Транзит через дім

Заздалегідь написані тлумачення для транзиту планети через певний дім натальної карти: що, як вважається, приносить проходження Сонця через третій дім, що — проходження Сатурна через сьомий тощо, для дев’яти планет у дванадцяти домах. Лише довідник: передайте `planet` і `house` і отримаєте текст. Дата, час і місце тут не потрібні, тож поєднуйте його з розрахунком, який показує, у якому домі зараз стоїть кожна планета. Використовуйте разом із `/api/astro/planet_transit_natal_planets/`, який охоплює другу половину транзитного звіту: контакт транзитної планети з натальною планетою, а не з домом.

https://api.occultapi.com/api/astro/planet_transit_over_house/

Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

Поле	Тип	Обов’язкове	Примітки
house	integer	обов’язковий
keys	array	обов’язковий	Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами.
planet	string	обов’язковий	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Точний збіг у нижньому регістрі. Невідоме значення повертає "Invalid key: <x>" з HTTP 200. (Супутнє поле `house` — цілочисельний індекс у списку з нумерацією від 0 — див. приклад у __main__.)

Доступні ключі (1)

Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.

Ключ	Додаткові поля	Опис
get_planet_transit_over_house	planet, house	Тлумачення для транзиту `planet` через дім, заданий `house`. Повертає список коротких фраз, зазвичай від двох до чотирьох, кожна — окреме твердження про це проходження.

Приклад запиту

curl -X POST https://api.occultapi.com/api/astro/planet_transit_over_house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_transit_over_house"],"planet":"Sun","house":3}'

Відповідь

{
  "data": {
    "get_planet_transit_over_house": [
      "Irritable temper",
      "Gains physical strength, fame, and honour"
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.