POST/api/astro/tarot/draw/1 кредит

Вытягивание карт таро

Вытягивает карты из перетасованной колоды Rider-Waite-Smith из семидесяти восьми карт. Карты вытягиваются без возврата в колоду, поэтому в одном вытягивании карта не повторяется. Для каждой карты возвращаются аркан, масть, ранг, номер, положение и стандартные ключевые слова для того положения, в котором она выпала. Каждый ответ содержит `seed`, по которому он получен, и если передать этот seed снова, выбор карт повторится в точности — те же карты, в том же порядке и в том же положении. Если seed не указан, он генерируется и возвращается в ответе: по умолчанию карты тянутся заново, но повторить результат потом можно всегда. Благодаря этому клиент может сохранить расклад и показать его снова, а не давать вопрошающему другой ответ на тот же вопрос. `allow_reversed` и `reversal_chance` нужны потому, что тарологи работают по-разному: одни используют только прямое положение, другие переворачивают около половины колоды, третьи — гораздо меньше.

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

Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

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

Поля запроса

Поле	Тип	Обязательно	Примечания
allow_reversed	boolean	необязательный	Могут ли карты выпадать в перевёрнутом положении. Некоторые тарологи работают только с прямым положением.
count	integer	необязательный	Сколько карт вытянуть, не более 21. Карты вытягиваются без возврата, поэтому ни одна не может повториться. min 1 · max 21
question	string	необязательный	Необязательно. Возвращается в ответе без изменений и подмешивается в генерируемый seed.
reversal_chance	number (double)	необязательный	Вероятность перевёрнутого положения, если перевёрнутые карты разрешены. min 0 · max 1
seed	string	необязательный	Передайте seed, чтобы в точности воспроизвести вытягивание. Если его не указывать, seed генерируется и возвращается, поэтому любое вытягивание можно потом повторить.

Пример запроса

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

Ответ

{
  "data": {
    "question": "What should I focus on this month?",
    "seed": "sample-draw",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 50,
        "name": "Ace of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ace",
        "number": 1,
        "element": "air",
        "upright": "clarity, breakthrough, truth cutting through",
        "reversed": "confusion, a truth misused",
        "orientation": "reversed",
        "meaning": "confusion, a truth misused",
        "yes_no": "no"
      },
      {
        "position": 2,
        "id": 32,
        "name": "Page of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Page",
        "number": 11,
        "element": "fire",
        "upright": "curiosity, an idea, enthusiasm",
        "reversed": "unfocused energy, an idea unformed",
        "orientation": "reversed",
        "meaning": "unfocused energy, an idea unformed",
        "yes_no": "no"
      },
      {
        "position": 3,
        "id": 31,
        "name": "Ten of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Ten",
        "number": 10,
        "element": "fire",
        "upright": "burden, overload, carrying too much",
        "reversed": "putting a load down, delegation",
        "orientation": "upright",
        "meaning": "burden, overload, carrying too much",
        "yes_no": "no"
      }
    ],
    "count": 3
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

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