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