curl -X POST https://api.occultapi.com/api/astro/tarot/draw/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"What should I focus on this month?","count":3,"seed":"sample-draw"}'
Вытягивает карты из перетасованной колоды Rider-Waite-Smith из семидесяти восьми карт.
Карты вытягиваются без возврата в колоду, поэтому в одном вытягивании карта не повторяется. Для каждой карты возвращаются аркан, масть, ранг, номер, положение и стандартные ключевые слова для того положения, в котором она выпала.
Каждый ответ содержит `seed`, по которому он получен, и если передать этот seed снова, выбор карт повторится в точности — те же карты, в том же порядке и в том же положении. Если seed не указан, он генерируется и возвращается в ответе: по умолчанию карты тянутся заново, но повторить результат потом можно всегда. Благодаря этому клиент может сохранить расклад и показать его снова, а не давать вопрошающему другой ответ на тот же вопрос.
`allow_reversed` и `reversal_chance` нужны потому, что тарологи работают по-разному: одни используют только прямое положение, другие переворачивают около половины колоды, третьи — гораздо меньше.
Поля запроса
Поле
Тип
Обязательно
Примечания
allow_reversed
boolean
необязательный
Могут ли карты выпадать в перевёрнутом положении. Некоторые тарологи работают только с прямым положением.
count
integer
необязательный
Сколько карт вытянуть, не более 21. Карты вытягиваются без возврата, поэтому ни одна не может повториться.
min 1 · max 21
question
string
необязательный
Необязательно. Возвращается в ответе без изменений и подмешивается в генерируемый seed.
reversal_chance
number (double)
необязательный
Вероятность перевёрнутого положения, если перевёрнутые карты разрешены.
min 0 · max 1
seed
string
необязательный
Передайте seed, чтобы в точности воспроизвести вытягивание. Если его не указывать, seed генерируется и возвращается, поэтому любое вытягивание можно потом повторить.
