POST/api/astro/tarot/yes-no/1 кредит

Таро: так чи ні

Одна карта, витягнута на запитання, з відповіддю «так», «ні» або «можливо». Правило, за яким визначається відповідь, указано явно: тарологи користуються різними підходами, і саме лише «так» не показує, за яким із них його отримано. Кожна карта має традиційний нахил: Сонце й Туз Кубків схиляються до «так», Вежа й Дев’ятка Мечів — до «ні», Двійка Мечів і Сімка Кубків — двозначні. Перевернуте положення змінює «так» на «ні», а «ні» на «так»; двозначна карта лишається двозначною в будь-якому положенні. Щоб тлумачити лише прямі карти, встановіть `allow_reversed` у false. Разом із вердиктом повертаються карта та всі її ключові слова, бо «ні» саме по собі ще не тлумачення: значення несе карта. Кожна відповідь містить `seed`, яким її отримано, і якщо надіслати це зерно назад, витягування відтвориться точно: ті самі карти, у тому самому порядку, тим самим боком догори. Якщо зерно не передати, його буде згенеровано й повернуто, тож за замовчуванням витягування нове, а повторити його згодом можна завжди. Саме це дає змогу клієнтові зберегти розклад і показати його знову, а не давати запитувачеві іншу відповідь на те саме запитання.

https://api.occultapi.com/api/astro/tarot/yes-no/

Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

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

Приклад запиту

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"}'

Відповідь

{
  "data": {
    "question": "Should I take the offer?",
    "seed": "sample-yesno",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 14,
        "name": "Temperance",
        "arcana": "major",
        "suit": null,
        "rank": null,
        "number": 14,
        "element": null,
        "upright": "balance, moderation, patience, blending",
        "reversed": "imbalance, excess, impatience",
        "orientation": "upright",
        "meaning": "balance, moderation, patience, blending",
        "yes_no": "yes"
      }
    ],
    "answer": "yes",
    "card": "Temperance",
    "orientation": "upright",
    "meaning": "balance, moderation, patience, blending",
    "how_decided": "Each card has a traditional leaning. A reversal flips yes to no and no to yes; an ambivalent card stays ambivalent. Conventions differ between readers, so this one is stated rather than left implicit."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.