Tarot
Tři balíčky: Rider-Waite-Smith (78 karet), Marseillské Taroty (78) a Lenormand (36). Každá karta v každé tarotové odpovědi má obrázek a POST /v1/interpret/tarot převádí výklad na interpretaci: každá pozice v kontextu, shrnutí celého výkladu a jedna rada.
Vyberte si vzhled karet
Sekce “Vyberte si vzhled karet”GET /v1/tarot/decks vrací každý balíček, jeho výklady a sady vzhledů, které můžeš předat jako art do jakékoli tarotové cesty (v těle POST nebo jako ?art= v GET). Všechny sady jsou ve veřejné doméně a jsou doručovány z našeho CDN.
| Balíček | art | Karet |
|---|---|---|
| Rider-Waite-Smith | rws-1909 (výchozí), rws-restored, rws-vector | 78 |
| Marseillské Taroty | arnoult-1748 | 78 |
| Lenormand | dondorf | 35 z 36, bez Měsíce |
Každá karta obdrží image s urlSmall (300 px na šířku, pro karty do přibližně 150 px na stránce), url (600 px), url2x (1200 px), width, height a art. Výklad také vrací back, rub karty, aby stránka mohla nejprve zobrazit karty lícem dolů. art jiného balíčku vrátí 400 INVALID_ART se seznamem povolených. Karta, pro kterou v sadě není obrázek (Měsíc v Lenormand), je uvedena v missing této sady a přichází bez image, takže pro ni zobraz textovou kartu.
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \ -H "X-Api-Key: aw_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "seed": 12345, "art": "rws-restored" }'{ "drawn": [ { "position": { "index": 0, "name": "Past", "meaning": "Forces from the past shaping the situation." }, "card": { "slug": "8-of-pentacles", "name": "Eight of Pentacles", "image": { "url": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles.webp", "url2x": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles@2x.webp", "urlSmall": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles-300.webp", "width": 600, "height": 1028, "art": "rws-restored" } }, "reversed": false } ], "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" }}Výklad POST /v1/tarot/rider-waite/draw/three-card stojí 10 kreditů.
Vlastní výklad a páry Lenormand
Sekce “Vlastní výklad a páry Lenormand”POST /v1/tarot/rider-waite/draw/custom, /tarot/marseille/draw/custom a /tarot/lenormand/draw/custom položí od 1 do 15 karet do pozic, které si pojmenuješ sám (positions: ["Já", "Ty", "My"]), nebo prostě count karet. Míchání je stejné jako u hotových výkladů, takže se stejným seed se tři karty vlastního výkladu shodují s kartami three-card.
POST /v1/tarot/lenormand/combination čte dvě karty Lenormand jako pár: první pojmenovává předmět, druhá ho popisuje, takže na pořadí záleží ({ "cards": ["heart", "ring"] } dává “Love and feeling, bound by agreement.”). Odpověď obsahuje i čtení v opačném pořadí a celkový tón páru. Fráze pro každou kartu jsme napsali my z hlavních významů karet, tabulka párů není od nikoho zkopírována. Po 10 kreditech.
Odpověď ano/ne na jednu kartu už je k dispozici: POST /v1/tarot/rider-waite/draw/decision a /v1/tarot/marseille/draw/decision vrací verdict (yes, no, maybe) a důvod.
Texty karet bez modelu
Sekce “Texty karet bez modelu”GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk funguje bez klíče a vrací pro každou kartu description se třemi odstavci (obrázek, přímý význam, obrácený význam) a text o love, career, finance, health a spirit pro upright a reversed, spolu s lokalizovaným názvem name a až pěti keywords pro každou stranu. Bez cards přichází všech 78. Texty se nemění, takže si stáhni karty, které stránka zobrazuje, a kešuj je.
curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'Interpretace celého výkladu
Sekce “Interpretace celého výkladu”POST /v1/interpret/tarot přijímá balíček, výklad, karty a volitelnou otázku a píše interpretaci v jazyce z language (21 jazyků). Karty můžeš předat jako slugy, objekty { "slug", "reversed" } nebo pole drawn z jakékoli odpovědi výkladu beze změn.
const headers = { 'Content-Type': 'application/json', 'X-Api-Key': process.env.ASTROWAY_API_KEY };const api = (path, body) => fetch(`https://api.astroway.info/v1${path}`, { method: 'POST', headers, body: JSON.stringify(body) }).then((r) => r.json());
const { data: spread } = await api('/tarot/rider-waite/draw/three-card', { art: 'rws-1909' });const { data: reading } = await api('/interpret/tarot', { spread: 'three-card', question: 'What should I focus on at work?', cards: spread.drawn, language: 'en',});
for (const p of reading.positions) { console.log(p.position, p.card.name, p.reversed ? '(reversed)' : '', p.card.image.url); console.log(' ', p.reading);}console.log('Summary:', reading.synthesis);V odpovědi positions[] (pozice, karta s image, reversed, reading), synthesis, advice a disclaimer. Karty Rider-Waite-Smith mají také nameLocalized a positionLocalized v jazyce interpretace. Interpretace stojí 100 kreditů (Tier 4) a je dostupná na tarifu Free; s vlastním klíčem modelu je levnější, viz Vlastní klíč k modelu.