Перейти до вмісту
AstroWay/api v2.205.0 · docs
усі системи в нормі

Tarot Celtic Cross (public, no key)

GET
/public/tarot/celtic-cross
Code sample: cURL
request.sh
curl 'https://api.astroway.info/v1/public/tarot/celtic-cross?lang=en'

Ten-card Celtic Cross from the Rider-Waite-Smith deck, the same draw as POST /tarot/rider-waite/draw/celtic-cross. 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

Section titled “ Parameters ”

Query Parameters

Section titled “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 
4

Header Parameters

Section titled “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

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json
object
ok
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
number
nullable
name
string
nullable
category
string
nullable
suit
string
nullable
rank
string
nullable
element
string
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
astrology
string
nullable
numerology
number
nullable
yes
string
nullable
reversed
boolean
nullable
localized
object
cards
object
queen-of-pentacles
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
9-of-wands
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
death
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
king-of-swords
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
the-emperor
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
3-of-swords
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
3-of-wands
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
the-devil
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
knight-of-swords
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
the-world
object
name
string
nullable
suit
string
nullable
nameLocalized
boolean
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
textLocalized
boolean
nullable
positions
Array<object>
nullable
object
index
number
nullable
name
string
nullable
meaning
string
nullable
spread
object
name
string
nullable
textLocalized
boolean
nullable
_footer

Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

string
Example 
{
  "ok": true,
  "data": {
    "spread": {
      "slug": "celtic-cross",
      "name": "Celtic Cross",
      "cardCount": 10
    },
    "seed": 42,
    "drawn": [
      {
        "position": {
          "index": 0,
          "name": "Present",
          "meaning": "The heart of the matter now."
        },
        "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": "Crossing",
          "meaning": "Immediate challenge."
        },
        "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": "Crown",
          "meaning": "Conscious goal."
        },
        "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
      },
      {
        "position": {
          "index": 3,
          "name": "Foundation",
          "meaning": "Subconscious ground."
        },
        "card": {
          "slug": "king-of-swords",
          "number": 14,
          "name": "King of Swords",
          "category": "court",
          "suit": "swords",
          "rank": "king",
          "element": "air",
          "upright": {
            "keywords": [
              "intellectual authority",
              "truth",
              "ethical leadership"
            ],
            "meaning": "Ethical authority based on truth."
          },
          "reversed": {
            "keywords": [
              "manipulation",
              "tyranny of intellect"
            ],
            "meaning": "Cold or tyrannical use of mind."
          },
          "astrology": "air of fire",
          "numerology": 5,
          "yes": "yes"
        },
        "reversed": true
      },
      {
        "position": {
          "index": 4,
          "name": "Past",
          "meaning": "Recent past."
        },
        "card": {
          "number": 4,
          "name": "The Emperor",
          "upright": {
            "keywords": [
              "authority",
              "structure",
              "control",
              "fatherhood"
            ],
            "meaning": "Build solid structure; lead with discipline."
          },
          "reversed": {
            "keywords": [
              "tyranny",
              "rigidity",
              "lack of self-control"
            ],
            "meaning": "Authoritarian misuse of power or breakdown of structure."
          },
          "astrology": "Aries",
          "numerology": 4,
          "yes": "yes",
          "slug": "the-emperor",
          "category": "major"
        },
        "reversed": false
      },
      {
        "position": {
          "index": 5,
          "name": "Near Future",
          "meaning": "Approaching influence."
        },
        "card": {
          "slug": "3-of-swords",
          "number": 3,
          "name": "3 of Swords",
          "category": "minor",
          "suit": "swords",
          "rank": "3",
          "element": "air",
          "upright": {
            "keywords": [
              "heartbreak",
              "sorrow",
              "grief"
            ],
            "meaning": "Painful but necessary truth; grief."
          },
          "reversed": {
            "keywords": [
              "recovery",
              "forgiveness"
            ],
            "meaning": "Healing from heartbreak."
          },
          "astrology": "Saturn in Libra",
          "numerology": 3,
          "yes": "no"
        },
        "reversed": true
      },
      {
        "position": {
          "index": 6,
          "name": "Self",
          "meaning": "How you appear."
        },
        "card": {
          "slug": "3-of-wands",
          "number": 3,
          "name": "3 of Wands",
          "category": "minor",
          "suit": "wands",
          "rank": "3",
          "element": "fire",
          "upright": {
            "keywords": [
              "expansion",
              "foresight",
              "overseas opportunities"
            ],
            "meaning": "Expansion succeeding; outlook is good."
          },
          "reversed": {
            "keywords": [
              "delays",
              "frustration",
              "lack of foresight"
            ],
            "meaning": "Plans delayed by oversight."
          },
          "astrology": "Sun in Aries",
          "numerology": 3,
          "yes": "yes"
        },
        "reversed": false
      },
      {
        "position": {
          "index": 7,
          "name": "Environment",
          "meaning": "Outside forces."
        },
        "card": {
          "number": 15,
          "name": "The Devil",
          "upright": {
            "keywords": [
              "attachment",
              "addiction",
              "shadow",
              "materialism"
            ],
            "meaning": "Bondage by attachment or shadow content; see what holds you."
          },
          "reversed": {
            "keywords": [
              "breaking free",
              "release",
              "detachment"
            ],
            "meaning": "Breaking free of an attachment or addiction."
          },
          "astrology": "Capricorn",
          "numerology": 15,
          "yes": "no",
          "slug": "the-devil",
          "category": "major"
        },
        "reversed": true
      },
      {
        "position": {
          "index": 8,
          "name": "Hopes and Fears",
          "meaning": "Inner emotional layer."
        },
        "card": {
          "slug": "knight-of-swords",
          "number": 12,
          "name": "Knight of Swords",
          "category": "court",
          "suit": "swords",
          "rank": "knight",
          "element": "air",
          "upright": {
            "keywords": [
              "decisive action",
              "charging in"
            ],
            "meaning": "Bold action; rapid pursuit."
          },
          "reversed": {
            "keywords": [
              "recklessness",
              "aggression"
            ],
            "meaning": "Reckless aggression."
          },
          "astrology": "air of air",
          "numerology": 3,
          "yes": "yes"
        },
        "reversed": true
      },
      {
        "position": {
          "index": 9,
          "name": "Outcome",
          "meaning": "Likely outcome."
        },
        "card": {
          "number": 21,
          "name": "The World",
          "upright": {
            "keywords": [
              "completion",
              "integration",
              "accomplishment",
              "travel"
            ],
            "meaning": "Cycle complete; integration achieved; world opens."
          },
          "reversed": {
            "keywords": [
              "incomplete",
              "short-cuts",
              "lack of closure"
            ],
            "meaning": "Incomplete chapter; closure pending."
          },
          "astrology": "Saturn",
          "numerology": 21,
          "yes": "yes",
          "slug": "the-world",
          "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
        },
        "king-of-swords": {
          "name": "Король Мечів",
          "suit": "Мечі",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "інтелектуальний авторитет",
              "істина",
              "етичне лідерство"
            ],
            "meaning": "Етичний авторитет, заснований на істині."
          },
          "reversed": {
            "keywords": [
              "маніпуляція",
              "тиранія інтелекту"
            ],
            "meaning": "Холодне або тиранічне використання розуму."
          },
          "textLocalized": true
        },
        "the-emperor": {
          "name": "Імператор",
          "suit": "Старший Аркан",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "влада",
              "структура",
              "контроль",
              "батьківство"
            ],
            "meaning": "Будуй міцну структуру; веди за собою через дисципліну."
          },
          "reversed": {
            "keywords": [
              "тиранія",
              "негнучкість",
              "брак самоконтролю"
            ],
            "meaning": "Авторитарне зловживання владою або руйнування структури."
          },
          "textLocalized": true
        },
        "3-of-swords": {
          "name": "Трійка Мечів",
          "suit": "Мечі",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "розбите серце",
              "смуток",
              "горе"
            ],
            "meaning": "Болюча, але необхідна правда; горе."
          },
          "reversed": {
            "keywords": [
              "одужання",
              "прощення"
            ],
            "meaning": "Зцілення після розбитого серця."
          },
          "textLocalized": true
        },
        "3-of-wands": {
          "name": "Трійка Жезлів",
          "suit": "Жезли",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "розширення",
              "передбачливість",
              "можливості за кордоном"
            ],
            "meaning": "Розширення вдається; перспективи добрі."
          },
          "reversed": {
            "keywords": [
              "затримки",
              "розчарування",
              "брак передбачливості"
            ],
            "meaning": "Плани затримуються через недогляд."
          },
          "textLocalized": true
        },
        "the-devil": {
          "name": "Диявол",
          "suit": "Старший Аркан",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "прив'язаність",
              "залежність",
              "тінь",
              "матеріалізм"
            ],
            "meaning": "Кайдани прив'язаності або тіньового змісту; побач, що тебе тримає."
          },
          "reversed": {
            "keywords": [
              "звільнення",
              "вивільнення",
              "відстороненість"
            ],
            "meaning": "Звільнення від прив'язаності або залежності."
          },
          "textLocalized": true
        },
        "knight-of-swords": {
          "name": "Лицар Мечів",
          "suit": "Мечі",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "рішучі дії",
              "стрімкий натиск"
            ],
            "meaning": "Сміливі дії; швидке переслідування мети."
          },
          "reversed": {
            "keywords": [
              "безрозсудність",
              "агресія"
            ],
            "meaning": "Безрозсудна агресія."
          },
          "textLocalized": true
        },
        "the-world": {
          "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": "Усвідомлена мета."
        },
        {
          "index": 3,
          "name": "Основа",
          "meaning": "Підсвідоме підґрунтя."
        },
        {
          "index": 4,
          "name": "Минуле",
          "meaning": "Недавнє минуле."
        },
        {
          "index": 5,
          "name": "Найближче майбутнє",
          "meaning": "Вплив, що наближається."
        },
        {
          "index": 6,
          "name": "Я",
          "meaning": "Яким ти постаєш."
        },
        {
          "index": 7,
          "name": "Оточення",
          "meaning": "Зовнішні сили."
        },
        {
          "index": 8,
          "name": "Надії та страхи",
          "meaning": "Внутрішній емоційний шар."
        },
        {
          "index": 9,
          "name": "Результат",
          "meaning": "Ймовірний результат."
        }
      ],
      "spread": {
        "name": "Кельтський хрест"
      },
      "textLocalized": true
    }
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Section titled “400 ”

Invalid sign or date

Media type application/json
Example 
{
  "ok": false,
  "error": {
    "code": "INVALID_SIGN",
    "message": "sign must be one of the 12 zodiac signs"
  }
}
Корисно?
Запропонувати правку