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"}'
Розклад із назвою та підписом кожної позиції.
Шість схем — від однієї карти до десятикарткового Кельтського хреста, а також минуле/теперішнє/майбутнє, ситуація/дія/результат, п’ятикартковий розклад на стосунки та семикарткова Підкова.
Уся суть — у підписах. Три непідписані карти — це просто три карти, а «Минуле, теперішнє, майбутнє» — уже тлумачення. Кожна карта повертається разом із позицією, на яку вона випала, і значенням цієї позиції.
Кожна відповідь містить `seed`, яким її отримано, і якщо надіслати це зерно назад, витягування відтвориться точно: ті самі карти, у тому самому порядку, тим самим боком догори. Якщо зерно не передати, його буде згенеровано й повернуто, тож за замовчуванням витягування нове, а повторити його згодом можна завжди. Саме це дає змогу клієнтові зберегти розклад і показати його знову, а не давати запитувачеві іншу відповідь на те саме запитання.
Поля запиту
Поле
Тип
Обов’язкове
Примітки
allow_reversed
boolean
необов’язковий
Чи можуть карти випадати перевернутими. Деякі тарологи працюють лише з прямими картами.
question
string
необов’язковий
Необов’язкове. Повертається у відповіді й ураховується під час генерування зерна.
reversal_chance
number (double)
необов’язковий
Імовірність перевернутої карти, якщо перевернуті карти дозволено.
min 0 · max 1
seed
string
необов’язковий
Надішліть зерно, щоб точно відтворити витягування. Якщо його не передати, воно буде згенероване й повернуте, тож будь-яке витягування можна згодом повторити.