Skip to content

Latest commit

 

History

History
26 lines (16 loc) · 998 Bytes

README.md

File metadata and controls

26 lines (16 loc) · 998 Bytes

Tarot Card API

Provides information parsed from AE Waite's The Pictorial Key to the Tarot in OpenAPI 3 format (sorta).

For all your cybermysticism needs. 🔮

GET path Result Params
/ or /cards return all cards
/api/v1/cards/:name_short return card with specified name_short minors: /swac, /wa02, ..., /cupa, /pequ, /waqu, /swki, majors /ar01, /ar02, .../ar[n]
/api/v1/cards/search search all cards q={text}, meaning={text}, meaning_rev={text}
/api/v1/cards/random get random card(s) optional n={integer <= 78}

Examples:

Get all cards with word "peace" in meaning (reversed or upright):

https://rws-cards-api.herokuapp.com/api/v1/cards/search?meaning=peace (free dyno == super slow, sorry)

Get 10 random cards:

https://rws-cards-api.herokuapp.com/api/v1/cards/random?n=10

Get the Knight of Wands:

https://rws-cards-api.herokuapp.com/api/v1/cards/wakn