Tarot

Drei Decks: Rider-Waite-Smith (78 Karten), Marseiller Tarot (78) und Lenormand (36). Jede Karte in jeder Tarot-Antwort hat ein Bild, und POST /v1/interpret/tarot wandelt das Layout in eine Interpretation um: jede Position im Kontext, die Zusammenfassung des gesamten Layouts und ein Rat.

Wähle das Karten-Design

GET /v1/tarot/decks gibt jedes Deck, seine Layouts und die verfügbaren Kunststil-Sets zurück, die als art an jede Tarot-Route übergeben werden können (im POST-Body oder als ?art= bei GET). Alle Sets sind gemeinfrei und werden von unserem CDN bereitgestellt.

Deck	art	Karten
Rider-Waite-Smith	rws-1909 (standard), rws-restored, rws-vector	78
Marseiller Tarot	arnoult-1748	78
Lenormand	dondorf	35 von 36, ohne Mond

Jede Karte erhält ein image mit urlSmall (300 px Breite, für Karten bis zu etwa 150 px auf der Seite), url (600 px), url2x (1200 px), width, height und art. Das Layout gibt auch back zurück, die Rückseite der Karte, damit die Seite zunächst die Karten verdeckt zeigen kann. Ein art von einem anderen Deck führt zu 400 INVALID_ART mit einer Liste der gültigen Werte. Eine Karte, für die im Set kein Bild vorhanden ist (der Mond beim Lenormand), ist in missing dieses Sets aufgeführt und kommt ohne image an – zeige dafür stattdessen eine Textkarte an.

cURL

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" }
}

Der Layout POST /v1/tarot/rider-waite/draw/three-card kostet 10 Credits.

Kartentexte ohne Modell

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk funktioniert ohne Schlüssel und gibt für jede Karte eine description mit drei Absätzen (Bild, direkte Bedeutung, umgekehrte Bedeutung) sowie Texte zu love, career, finance, health und spirit für upright und reversed, zusammen mit dem lokalisierten Namen name und bis zu fünf keywords pro Seite. Ohne cards werden alle 78 zurückgegeben. Da die Texte sich nicht ändern, lade die Karten, die die Seite anzeigt, herunter und speichere sie im Cache.

curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'

Interpretation des gesamten Layouts

POST /v1/interpret/tarot nimmt ein Deck, ein Layout, Karten und eine optionale Frage entgegen und schreibt die Interpretation in der Sprache aus language (21 Sprachen). Karten können als einzelne Werte, als Objekte { "slug", "reversed" } oder als Array drawn aus jeder Layoutantwort ohne Änderungen übergeben werden.

Node.js

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);

In der Antwort enthält positions[] (Position, Karte mit image, reversed, reading), synthesis, advice und disclaimer. Karten von Rider-Waite-Smith besitzen außerdem nameLocalized und positionLocalized in der Sprache der Interpretation. Die Interpretation kostet 100 Credits (Tier 4) und ist im Free-Plan verfügbar; mit deinem Modellschlüssel ist sie günstiger, sieh dir Dein Modellschlüssel>.

Hinweis

Die Interpretation ist ein generierter Text basierend auf der traditionellen Bedeutung jeder Karte in ihrer Position. Das API verknüpft die Karten, ihre Lage und Positionen mit deiner Anfrage und verwirft Interpretationen, die eine Karte auslassen, aber nimm den Text als Anregung zum Nachdenken, nicht als Vorhersage.