Tarot
Három pakli: Rider-Waite-Smith (78 kártya), Marseille Tarot (78) és Lenormand (36). Minden kártya minden tarot válaszban képet kap, és a POST /v1/interpret/tarot átalakítja a kiterítést értelmezéssé: minden pozíció a kontextusban, a teljes kiterítés összefoglalása és egy tanács.
Válaszd ki a kártyák megjelenését
Szekció neve “Válaszd ki a kártyák megjelenését”GET /v1/tarot/decks visszaadja minden paklit, annak kiterítéseit és a megjelenítési készleteket, amelyeket art‑ként lehet átadni bármely tarot útvonalnak (a POST törzsben vagy ?art=‑ként a GET‑ben). Minden készlet közközönség tulajdonú és a mi CDN‑ünkről kerül kiszolgálásra.
| Pakli | art | Kártyák |
|---|---|---|
| Rider-Waite-Smith | rws-1909 (alapértelmezett), rws-restored, rws-vector | 78 |
| Marseille Tarot | arnoult-1748 | 78 |
| Lenormand | dondorf | 35 a 36‑ból, a Hold nélkül |
Minden kártya kap egy image‑t a urlSmall‑val (300 px szélesség, a kártyákhoz kb. 150 px a lapon), url‑val (600 px), url2x‑val (1200 px), width, height és art. A kiterítés továbbá visszaad egy back‑et, a kártya hátoldalát, hogy az oldal először lefelé néző kártyákat mutathasson. Egy másik pakli art‑ja 400 INVALID_ART‑t ad a megengedett listával. Az a kártya, amelyhez a készletben nincs kép (a Hold a Lenormand‑ban), a missing‑ben szerepel, és image nélkül érkezik, ezért jeleníts meg helyette egy szöveges kártyát.
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" }}A POST /v1/tarot/rider-waite/draw/three-card kiterítés 10 kredit-be kerül.
Kártyaszövegek modell nélkül
Szekció neve “Kártyaszövegek modell nélkül”GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk kulcs nélkül működik, és minden kártyához egy description‑t ad vissza három bekezdésben (kép, egyenes jelentés, fordított jelentés) valamint szöveget a love, career, finance, health és spirit témákról upright és reversed esetén, a lokalizált name‑nel és legfeljebb öt keywords‑kel mindkét oldalra. cards nélkül az összes 78 érkezik. A szövegek nem változnak, ezért töltsd le a lap által megjelenített kártyákat, és cache‑ld őket.
curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'A teljes kiterítés értelmezése
Szekció neve “A teljes kiterítés értelmezése”POST /v1/interpret/tarot elfogad egy paklit, egy kiterítést, kártyákat és egy opcionális kérdést, és egy értelmezést ír a language nyelven (21 nyelv). A kártyákat slug‑okkal, objektumokkal { "slug", "reversed" } vagy egy drawn tömbbel lehet átadni bármely kiterítési válaszból változtatás nélkül.
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);A válaszban positions[] (pozíció, kártya image‑rel, reversed, reading), synthesis, advice és disclaimer. A Rider-Waite-Smith kártyáknak van nameLocalized és positionLocalized a választott nyelven. Az értelmezés 100 kredit-be kerül (Tier 4), és a Free tarifán elérhető; saját modellkulccsal olcsóbb, lásd a Saját modellkulcs.