Tarot three-card spread (public, no key)

GET

/public/tarot/three-card

cURL

curl 'https://api.astroway.info/v1/public/tarot/three-card?lang=en'

Past, present, future from the Rider-Waite-Smith deck, the same draw as POST /tarot/rider-waite/draw/three-card. Reversals included. Random per call unless seed is given, and never cached. localized follows ?lang= / Accept-Language and carries, keyed by slug, the card name and suit, upright and reversed with keywords and meaning, plus positions (same order and index as the spread), and spread.name, in 21 languages: uk en ru de pl es pt fr it nl cs ro hu el tr ar hi ja ko vi id. nameLocalized says the name is in that language; textLocalized (per card and for the spread) says the same for the prose. The English fields beside it are the stable identifiers and never change.

Parameters

Query Parameters

seed

integer

<= 4294967295

Integer 0-4294967295. The same seed always draws the same cards; without it every call is a new random draw.

lang

string

Example

en

Language for this call, overriding Accept-Language. The canonical per-call form: a page that renders in one language passes it here rather than reconfiguring its client. Unknown or inactive codes fall back to uk.

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

Header Parameters

Accept-Language

string

BCP-47 language (e.g. uk, en, de). Set it once on your HTTP client as its default; for a single call, ?lang= overrides it. Unknown or inactive codes fall back to uk.

Responses

200

application/json

object

boolean

data

object

spread

object

slug

string

nullable

name

string

nullable

cardCount

number

nullable

seed

number

nullable

drawn

Array<object>

nullable

object

position

object

index

number

nullable

name

string

nullable

meaning

string

nullable

card

object

slug

string

nullable

number

nullable

name

string

nullable

Example

{
  "ok": true,
  "data": {
    "spread": {
      "slug": "three-card",
      "name": "Past / Present / Future",
      "cardCount": 3
    },
    "seed": 42,
    "drawn": [
      {
        "position": {
          "index": 0,
          "name": "Past",
          "meaning": "Forces from the past shaping the situation."
        },
        "card": {
          "slug": "queen-of-pentacles",
          "number": 13,
          "name": "Queen of Pentacles",
          "category": "court",
          "suit": "pentacles",
          "rank": "queen",
          "element": "earth",
          "upright": {
            "keywords": [
              "nurture",
              "practical",
              "down-to-earth"
            ],
            "meaning": "Nurturing practical energy; abundance through care."
          },
          "reversed": {
            "keywords": [
              "smothering",
              "work-life imbalance"
            ],
            "meaning": "Smothering or imbalanced nurture."
          },
          "astrology": "earth of water",
          "numerology": 4,
          "yes": "yes"
        },
        "reversed": false
      },
      {
        "position": {
          "index": 1,
          "name": "Present",
          "meaning": "Energies active in the present."
        },
        "card": {
          "slug": "9-of-wands",
          "number": 9,
          "name": "9 of Wands",
          "category": "minor",
          "suit": "wands",
          "rank": "9",
          "element": "fire",
          "upright": {
            "keywords": [
              "resilience",
              "last stand",
              "persistence"
            ],
            "meaning": "You have what it takes; one more push."
          },
          "reversed": {
            "keywords": [
              "exhaustion",
              "paranoia"
            ],
            "meaning": "Battle fatigue; need rest."
          },
          "astrology": "Moon in Sagittarius",
          "numerology": 9,
          "yes": "maybe"
        },
        "reversed": true
      },
      {
        "position": {
          "index": 2,
          "name": "Future",
          "meaning": "Likely outcome if current course continues."
        },
        "card": {
          "number": 13,
          "name": "Death",
          "upright": {
            "keywords": [
              "transformation",
              "endings",
              "transition",
              "rebirth"
            ],
            "meaning": "Major chapter ending; clear away what is finished."
          },
          "reversed": {
            "keywords": [
              "resistance to change",
              "inability to let go"
            ],
            "meaning": "Refusing the end of a chapter; clinging to what is dead."
          },
          "astrology": "Scorpio",
          "numerology": 13,
          "yes": "no",
          "slug": "death",
          "category": "major"
        },
        "reversed": false
      }
    ],
    "localized": {
      "cards": {
        "queen-of-pentacles": {
          "name": "Королева Пентаклів",
          "suit": "Пентаклі",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "турбота",
              "практичність",
              "приземленість"
            ],
            "meaning": "Турботлива практична енергія; достаток через турботу."
          },
          "reversed": {
            "keywords": [
              "надмірна опіка",
              "дисбаланс роботи й життя"
            ],
            "meaning": "Задушлива або незбалансована турбота."
          },
          "textLocalized": true
        },
        "9-of-wands": {
          "name": "Дев’ятка Жезлів",
          "suit": "Жезли",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "стійкість",
              "останній рубіж",
              "наполегливість"
            ],
            "meaning": "У тебе є все необхідне; ще одне зусилля."
          },
          "reversed": {
            "keywords": [
              "виснаження",
              "параноя"
            ],
            "meaning": "Бойова втома; потрібен відпочинок."
          },
          "textLocalized": true
        },
        "death": {
          "name": "Смерть",
          "suit": "Старший Аркан",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "трансформація",
              "завершення",
              "перехід",
              "переродження"
            ],
            "meaning": "Завершується великий розділ; прибери те, що вже скінчилося."
          },
          "reversed": {
            "keywords": [
              "опір змінам",
              "нездатність відпустити"
            ],
            "meaning": "Небажання закрити розділ; чіпляння за те, що вже мертве."
          },
          "textLocalized": true
        }
      },
      "positions": [
        {
          "index": 0,
          "name": "Минуле",
          "meaning": "Сили з минулого, що формують ситуацію."
        },
        {
          "index": 1,
          "name": "Теперішнє",
          "meaning": "Енергії, активні зараз."
        },
        {
          "index": 2,
          "name": "Майбутнє",
          "meaning": "Ймовірний результат, якщо нинішній курс збережеться."
        }
      ],
      "spread": {
        "name": "Минуле / Теперішнє / Майбутнє"
      },
      "textLocalized": true
    }
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Invalid sign or date

application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_SIGN",
    "message": "sign must be one of the 12 zodiac signs"
  }
}

Корисно?

Запропонувати правку

// Назад

Tarot Card of the Day (public, no key)

Далі //

Tarot Celtic Cross (public, no key)