Tarot
Trzy talie: Rider-Waite-Smith (78 kart), Marsylskie Tarot (78) i Lenormand (36). Każda karta w każdej odpowiedzi tarota ma obrazek, a POST /v1/interpret/tarot przekłada rozkład na interpretację: każda pozycja w kontekście, podsumowanie całego rozkładu i jedna rada.
Wybierz styl kart
Dział zatytułowany „Wybierz styl kart”GET /v1/tarot/decks zwraca każdą talię, jej rozkłady i zestawy stylów, które można przekazać jako art w dowolnej ścieżce tarota (w ciele POST lub jako ?art= w GET). Wszystkie zestawy są własnością publiczną i są dostarczane z naszego CDN.
| Talia | art | Liczba kart |
|---|---|---|
| Rider-Waite-Smith | rws-1909 (domyślnie), rws-restored, rws-vector | 78 |
| Marsylskie Tarot | arnoult-1748 | 78 |
| Lenormand | dondorf | 35 z 36, bez Księżyca |
Każda karta otrzymuje image z urlSmall (300 px szerokości, dla kart do około 150 px na stronie), url (600 px), url2x (1200 px), width, height i art. Rozkład zwraca również back, czyli rewers karty, aby strona mogła najpierw pokazać karty obrazkiem do dołu. art z innej talii zwraca błąd 400 INVALID_ART z listą dozwolonych wartości. Karta, dla której w zestawie nie ma obrazka (Księżyc w Lenormand), jest wskazana w missing tego zestawu i przychodzi bez image, więc wyświetl dla niej tekstową kartę.
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" }}Rozkład POST /v1/tarot/rider-waite/draw/three-card kosztuje 10 kredytów.
Teksty kart bez modelu
Dział zatytułowany „Teksty kart bez modelu”GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk działa bez klucza i zwraca dla każdej karty description składającą się z trzech akapitów (obraz, znaczenie proste, znaczenie odwrócone) oraz tekst dotyczący love, career, finance, health i spirit dla upright i reversed, razem ze zlokalizowaną nazwą name i do pięciu keywords na każdą stronę. Bez parametru cards zwracane są wszystkie 78 kart. Teksty nie ulegają zmianom, więc pobieraj karty, które wyświetla strona, i buforuj je.
curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'Interpretacja całego rozkładu
Dział zatytułowany „Interpretacja całego rozkładu”POST /v1/interpret/tarot przyjmuje talię, rozkład, karty oraz opcjonalne pytanie i pisze interpretację w języku określonym przez language (21 języków). Kart można przekazywać jako osobne argumenty, obiekty { "slug", "reversed" } lub tablicę drawn z dowolnej odpowiedzi rozkładu bez zmian.
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);W odpowiedzi positions[] (pozycja, karta z image, reversed, reading), synthesis, advice i disclaimer. Karty Rider-Waite-Smith mają również nameLocalized i positionLocalized w języku interpretacji. Interpretacja kosztuje 100 kredytów (Tier 4) i jest dostępna w planie Free; przy użyciu własnego klucza modelu jest tańsza, zobacz Swój klucz do modelu.