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. Подробнее — в справочнике ошибок.