POSThttps://api.occultapi.com/api/astro/tarot/draw/

Витягування карт Таро

Тіло запитуJSON

Щоб надіслати запит, вставте API-ключ вище.

Фрагмент коду

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`, яким її отримано, і якщо надіслати це зерно назад, витягування відтвориться точно: ті самі карти, у тому самому порядку, тим самим боком догори. Якщо зерно не передати, його буде згенеровано й повернуто, тож за замовчуванням витягування нове, а повторити його згодом можна завжди. Саме це дає змогу клієнтові зберегти розклад і показати його знову, а не давати запитувачеві іншу відповідь на те саме запитання. `allow_reversed` і `reversal_chance` потрібні, бо тарологи працюють по-різному: одні — лише з прямими картами, інші перевертають близько половини колоди, а ще інші — значно менше.

Поля запиту

Поле	Тип	Обов’язкове	Примітки
allow_reversed	boolean	необов’язковий	Чи можуть карти випадати перевернутими. Деякі тарологи працюють лише з прямими картами.
count	integer	необов’язковий	Скільки карт витягнути, не більше 21. Карти витягуються без повернення, тож жодна не повториться. min 1 · max 21
question	string	необов’язковий	Необов’язкове. Повертається у відповіді й ураховується під час генерування зерна.
reversal_chance	number (double)	необов’язковий	Імовірність перевернутої карти, якщо перевернуті карти дозволено. min 0 · max 1
seed	string	необов’язковий	Надішліть зерно, щоб точно відтворити витягування. Якщо його не передати, воно буде згенероване й повернуте, тож будь-яке витягування можна згодом повторити.

Повний довідник цього ендпоінта