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

Tarot decks and card art (public, no key)

GET
/public/tarot/decks
Code sample: cURL
request.sh
curl 'https://api.astroway.info/v1/public/tarot/decks'

Every deck with its spreads and the public-domain card art sets: id, artist, year, licence, source, a preview image, the card back, and any card a set has no picture for. The same answer as GET /tarot/decks. Cached for a day.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
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

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json
object
ok
boolean
data
object
items
Array<object>
nullable
object
deck
string
nullable
name
string
nullable
cards
number
nullable
spreads
Array<object>
nullable
object
slug
string
nullable
name
string
nullable
cardCount
number
nullable
art
Array<object>
nullable
object
id
string
nullable
name
string
nullable
artist
string
nullable
year
string
nullable
licence
string
nullable
source
string
nullable
note
string
nullable
preview
object
url
string
nullable
url2x
string
nullable
urlSmall
string
nullable
width
number
nullable
height
number
nullable
art
string
nullable
back
object
url
string
nullable
url2x
string
nullable
urlSmall
string
nullable
width
number
nullable
height
number
nullable
art
string
nullable
missing
Array
nullable
_footer

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

string
Example 
{
  "ok": true,
  "data": {
    "items": [
      {
        "deck": "rider-waite",
        "name": "Rider-Waite-Smith",
        "cards": 78,
        "spreads": [
          {
            "slug": "single-card",
            "name": "Single Card",
            "cardCount": 1
          },
          {
            "slug": "three-card",
            "name": "Past / Present / Future",
            "cardCount": 3
          },
          {
            "slug": "celtic-cross",
            "name": "Celtic Cross",
            "cardCount": 10
          },
          {
            "slug": "horseshoe",
            "name": "Horseshoe",
            "cardCount": 7
          },
          {
            "slug": "relationship",
            "name": "Relationship",
            "cardCount": 7
          },
          {
            "slug": "year-ahead",
            "name": "Year Ahead",
            "cardCount": 13
          },
          {
            "slug": "decision",
            "name": "Yes / No Decision",
            "cardCount": 1
          },
          {
            "slug": "chakra",
            "name": "Chakra Spread",
            "cardCount": 7
          },
          {
            "slug": "career",
            "name": "Career",
            "cardCount": 5
          },
          {
            "slug": "love-triangle",
            "name": "Love Triangle",
            "cardCount": 6
          },
          {
            "slug": "spiritual-path",
            "name": "Spiritual Path",
            "cardCount": 5
          },
          {
            "slug": "shadow-work",
            "name": "Shadow Work",
            "cardCount": 6
          }
        ],
        "art": [
          {
            "id": "rws-1909",
            "name": "Rider-Waite-Smith 1909",
            "artist": "Pamela Colman Smith",
            "year": "1909",
            "licence": "Public domain",
            "source": "https://commons.wikimedia.org/wiki/Category:Rider-Waite_tarot_deck_(Roses_%26_Lilies)",
            "note": "The first printing, with the original colouring.",
            "preview": {
              "url": "https://cdn.astroway.info/tarot/rws-1909/the-fool.webp",
              "url2x": "https://cdn.astroway.info/tarot/rws-1909/the-fool@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/rws-1909/the-fool-300.webp",
              "width": 600,
              "height": 1039,
              "art": "rws-1909"
            },
            "back": {
              "url": "https://cdn.astroway.info/tarot/rws-1909/back.webp",
              "url2x": "https://cdn.astroway.info/tarot/rws-1909/back@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/rws-1909/back-300.webp",
              "width": 600,
              "height": 1039,
              "art": "rws-1909"
            },
            "missing": []
          },
          {
            "id": "rws-restored",
            "name": "Rider-Waite-Smith, restored",
            "artist": "Pamela Colman Smith",
            "year": "1909",
            "licence": "Public domain",
            "source": "https://commons.wikimedia.org/wiki/Category:Rider-Waite-Smith_tarot_deck_(Geldard)",
            "note": "A clean restoration of the 1909 art with even colour.",
            "preview": {
              "url": "https://cdn.astroway.info/tarot/rws-restored/the-fool.webp",
              "url2x": "https://cdn.astroway.info/tarot/rws-restored/the-fool@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/rws-restored/the-fool-300.webp",
              "width": 600,
              "height": 1028,
              "art": "rws-restored"
            },
            "back": {
              "url": "https://cdn.astroway.info/tarot/rws-1909/back.webp",
              "url2x": "https://cdn.astroway.info/tarot/rws-1909/back@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/rws-1909/back-300.webp",
              "width": 600,
              "height": 1039,
              "art": "rws-1909"
            },
            "missing": []
          },
          {
            "id": "rws-vector",
            "name": "Rider-Waite-Smith, vector",
            "artist": "Pamela Colman Smith, vectorised by Immanuelle",
            "year": "1909",
            "licence": "Public domain",
            "source": "https://commons.wikimedia.org/wiki/Category:Vectorized_Tarot_by_Immanuelle",
            "note": "Flat redrawn lines and colour, crisp at any size.",
            "preview": {
              "url": "https://cdn.astroway.info/tarot/rws-vector/the-fool.webp",
              "url2x": "https://cdn.astroway.info/tarot/rws-vector/the-fool@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/rws-vector/the-fool-300.webp",
              "width": 600,
              "height": 1000,
              "art": "rws-vector"
            },
            "back": {
              "url": "https://cdn.astroway.info/tarot/rws-vector/back.webp",
              "url2x": "https://cdn.astroway.info/tarot/rws-vector/back@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/rws-vector/back-300.webp",
              "width": 600,
              "height": 1000,
              "art": "rws-vector"
            },
            "missing": []
          }
        ]
      },
      {
        "deck": "marseille",
        "name": "Tarot de Marseille",
        "cards": 78,
        "spreads": [
          {
            "slug": "single-card",
            "name": "Single Card",
            "cardCount": 1
          },
          {
            "slug": "three-card",
            "name": "Three-Card",
            "cardCount": 3
          },
          {
            "slug": "jodorowsky-cross",
            "name": "Tirage Réduit (Jodorowsky Reduced Cross)",
            "cardCount": 5
          },
          {
            "slug": "jodorowsky-hero",
            "name": "Tirage du Héros (Jodorowsky Hero's Journey)",
            "cardCount": 6
          },
          {
            "slug": "seven-card",
            "name": "Seven-Card Pyramid",
            "cardCount": 7
          },
          {
            "slug": "celtic-cross",
            "name": "Celtic Cross (Marseille)",
            "cardCount": 10
          },
          {
            "slug": "decision",
            "name": "Decision",
            "cardCount": 1
          },
          {
            "slug": "love",
            "name": "Love Spread",
            "cardCount": 5
          },
          {
            "slug": "career",
            "name": "Career",
            "cardCount": 4
          },
          {
            "slug": "spiritual",
            "name": "Spiritual Path",
            "cardCount": 4
          }
        ],
        "art": [
          {
            "id": "arnoult-1748",
            "name": "Tarot de Marseille, Arnoult",
            "artist": "Arnoult",
            "year": "1748",
            "licence": "Public domain",
            "source": "https://gallica.bnf.fr/ark:/12148/btv1b10510965g",
            "note": null,
            "preview": {
              "url": "https://cdn.astroway.info/tarot/arnoult-1748/le-mat-the-fool-marseille.webp",
              "url2x": "https://cdn.astroway.info/tarot/arnoult-1748/le-mat-the-fool-marseille@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/arnoult-1748/le-mat-the-fool-marseille-300.webp",
              "width": 600,
              "height": 1096,
              "art": "arnoult-1748"
            },
            "back": null,
            "missing": []
          }
        ]
      },
      {
        "deck": "lenormand",
        "name": "Lenormand",
        "cards": 36,
        "spreads": [
          {
            "slug": "three-card",
            "name": "Three-Card Line",
            "cardCount": 3
          },
          {
            "slug": "grand-tableau",
            "name": "Grand Tableau",
            "cardCount": 36
          },
          {
            "slug": "nine-card-square",
            "name": "9-Card Square (3×3)",
            "cardCount": 9
          },
          {
            "slug": "line-of-five",
            "name": "Line of Five",
            "cardCount": 5
          },
          {
            "slug": "celtic-cross-lenormand",
            "name": "Detailed 10-Card Cross (modern hybrid)",
            "cardCount": 10
          },
          {
            "slug": "relationship",
            "name": "Relationship",
            "cardCount": 7
          }
        ],
        "art": [
          {
            "id": "dondorf",
            "name": "Lenormand, Dondorf",
            "artist": "B. Dondorf, Frankfurt",
            "year": "19th century",
            "licence": "Public domain",
            "source": "https://gallica.bnf.fr/ark:/12148/btv1b105431980",
            "note": "The scan lacks card 32, the Moon, which has no image in this set.",
            "preview": {
              "url": "https://cdn.astroway.info/tarot/dondorf/rider.webp",
              "url2x": "https://cdn.astroway.info/tarot/dondorf/rider@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/dondorf/rider-300.webp",
              "width": 600,
              "height": 958,
              "art": "dondorf"
            },
            "back": {
              "url": "https://cdn.astroway.info/tarot/dondorf/back.webp",
              "url2x": "https://cdn.astroway.info/tarot/dondorf/back@2x.webp",
              "urlSmall": "https://cdn.astroway.info/tarot/dondorf/back-300.webp",
              "width": 600,
              "height": 958,
              "art": "dondorf"
            },
            "missing": [
              "moon"
            ]
          }
        ]
      }
    ]
  },
  "_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"
  }
}
Корисно?
Запропонувати правку