curl -X POST https://api.occultapi.com/api/astro/tarot/yes-no/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"Should I take the offer?","seed":"sample-yesno"}'
Одна карта, вытянутая на вопрос и прочитанная как «да», «нет» или «возможно».
Как именно определяется ответ, указывается явно: у тарологов разные подходы, а голое "yes" скрывает, по какому из них он получен. У каждой карты есть традиционный уклон: Солнце и Туз Кубков склоняются к «да», Башня и Девятка Мечей — к «нет», Двойка Мечей и Семёрка Кубков неоднозначны. В перевёрнутом положении «да» становится «нет», а «нет» — «да»; неоднозначная карта остаётся неоднозначной в любом положении. Чтобы учитывать только прямое положение, передайте `allow_reversed` = false.
Карта и все её ключевые слова возвращаются вместе с вердиктом: одно "no" — ещё не толкование, смысл несёт именно карта.
Каждый ответ содержит `seed`, по которому он получен, и если передать этот seed снова, выбор карт повторится в точности — те же карты, в том же порядке и в том же положении. Если seed не указан, он генерируется и возвращается в ответе: по умолчанию карты тянутся заново, но повторить результат потом можно всегда. Благодаря этому клиент может сохранить расклад и показать его снова, а не давать вопрошающему другой ответ на тот же вопрос.
Поля запроса
Поле
Тип
Обязательно
Примечания
allow_reversed
boolean
необязательный
Могут ли карты выпадать в перевёрнутом положении. Некоторые тарологи работают только с прямым положением.
question
string
необязательный
Необязательно. Возвращается в ответе без изменений и подмешивается в генерируемый seed.
reversal_chance
number (double)
необязательный
Вероятность перевёрнутого положения, если перевёрнутые карты разрешены.
min 0 · max 1
seed
string
необязательный
Передайте seed, чтобы в точности воспроизвести вытягивание. Если его не указывать, seed генерируется и возвращается, поэтому любое вытягивание можно потом повторить.
