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

Транзит по натальной планете

Готовые толкования для транзита одной планеты по натальной позиции другой: транзитный Сатурн по натальной Луне, транзитный Юпитер по натальному Солнцу и так далее. Из такой попарной таблицы транзитов и собирается большинство транзитных отчётов. Это чистый справочник, расчёта карты за ним нет: передайте транзитную планету в `planet`, а планету натальной карты — в `natal_planet`, и получите текст. Сначала определите, какие контакты действительно активны, с помощью транзитного расчёта, например `/api/astro/transit/`, а текст получите здесь. Оба аргумента принимают девять тел, хотя среди транзитных планет нет Венеры. Порядок важен: Сатурн по натальному Солнцу и Солнце по натальному Сатурну — разные записи.

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

Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

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

Поля запроса

Поле	Тип	Обязательно	Примечания
keys	array	обязательный	Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами.
natal_planet	string	обязательный	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Точное совпадение в нижнем регистре. Для каждой транзитной планеты есть все 9 значений (проверено разбором AST таблицы соответствий). При неизвестном значении возвращается "Invalid key: <x>" с HTTP 200.
planet	string	обязательный	`sunmoonmarsmercuryjupitersaturnrahuketu` ПРИМЕЧАНИЕ: среди транзитных планет 'venus' НЕТ — в таблице соответствий только эти 8 ключей верхнего уровня. При неизвестном значении возвращается "Invalid key: <x>" с HTTP 200.

Доступные ключи (1)

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

Ключ	Доп. поля	Описание
get_planet_transit_natal_planets	planet, natal_planet	Толкование транзита `planet` по натальной позиции `natal_planet`. Возвращает список коротких фраз, обычно от двух до четырёх, каждая — отдельное утверждение о контакте. Порядок в паре важен: транзитную и натальную планеты нельзя поменять местами.

Пример запроса

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

Ответ

{
  "data": {
    "get_planet_transit_natal_planets": [
      "Start of a new solar cycle",
      "Brings new energy, optimism, and enthusiasm"
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

Ошибки

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