curl -X POST https://api.occultapi.com/api/astro/tarot/spread/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"How is this relationship placed?","spread":"three_card","seed":"sample-spread"}'
Расклад с названием и подписями всех позиций.
Шесть раскладов: от одной карты до Кельтского креста из десяти карт, а также «прошлое/настоящее/будущее», «ситуация/действие/результат», расклад на отношения из пяти карт и подкова из семи карт.
Весь смысл — в подписях. Три карты без подписей — это просто три карты, а "Past, Present, Future" — уже расклад. Каждая карта возвращается с позицией, на которую она легла, и значением этой позиции.
Каждый ответ содержит `seed`, по которому он получен, и если передать этот seed снова, выбор карт повторится в точности — те же карты, в том же порядке и в том же положении. Если seed не указан, он генерируется и возвращается в ответе: по умолчанию карты тянутся заново, но повторить результат потом можно всегда. Благодаря этому клиент может сохранить расклад и показать его снова, а не давать вопрошающему другой ответ на тот же вопрос.
Поля запроса
Поле
Тип
Обязательно
Примечания
allow_reversed
boolean
необязательный
Могут ли карты выпадать в перевёрнутом положении. Некоторые тарологи работают только с прямым положением.
question
string
необязательный
Необязательно. Возвращается в ответе без изменений и подмешивается в генерируемый seed.
reversal_chance
number (double)
необязательный
Вероятность перевёрнутого положения, если перевёрнутые карты разрешены.
min 0 · max 1
seed
string
необязательный
Передайте seed, чтобы в точности воспроизвести вытягивание. Если его не указывать, seed генерируется и возвращается, поэтому любое вытягивание можно потом повторить.