Embeddable Widgets

Tarot Spread (HTML)

Changed on

One to five RWS cards with art, position and meaning: single-card, three-card, decision or career. Fixed per date, or per visitor with seed.

get/embed/tarot-spread

Request

  • Base URL: https://api.astroway.info/v1
  • URL: https://api.astroway.info/v1/embed/tarot-spread
  • Auth: none required

Query parameters

datestring date

Calendar date YYYY-MM-DD. Defaults to today (UTC).

spread'single-card' | 'three-card' | 'decision' | 'career'

Spread, default three-card.

seedstring

Any string up to 64 characters. Without it every visitor sees the same draw for the date; pass a visitor id for a draw of their own.

reversed'0' | '1'

1 lets cards fall reversed.

artstring

Card art set id from GET /v1/tarot/decks, default rws-1909.

lang'uk' | 'en' | 'de' | 'ru' | 'pl' | 'es' | 'pt' | 'fr' | 'it' | 'nl' | 'cs' | 'ro' | 'hu' | 'el' | 'tr' | 'ar' | 'hi' | 'ja' | 'ko' | 'vi' | 'id'

Widget language. Also accepts the Accept-Language header.

theme'dark' | 'light' | 'console'

Colour scheme. Unknown values fall back to dark.

fieldsstring

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.

precisioninteger

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.

Response

Rendered widget markup, ready to drop into an iframe.

Changes