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. Детальніше — у довіднику помилок.