Tarot-API
Dieser Endpunkt führt eine geseedete, reproduzierbare Ziehung aus dem 78-Karten-Rider-Waite-Smith-Deck für die Drei-Karten-Legung durch. Er gibt die Metadaten der Legung, den ganzzahligen Seed, der das Mischen steuerte, und die gezogenen Karten mit ihren Positionen, Ausrichtungen und Bedeutungen zurück — sodass jede Legung durch erneutes Übergeben des Seeds exakt wiederholt werden kann.
Tarot-API
Anhand einer optionalen Frage und eines optionalen Seeds zieht der Endpunkt Karten aus dem vollständigen 78-Karten-Deck für die Drei-Karten-Auslage, wobei jede Karte an einer definierten Position landet und entweder aufrecht oder umgekehrt ausgerichtet ist. Die Antwort beschreibt die Legung selbst, gibt den verwendeten ganzzahligen Seed wieder und listet die gezogenen Karten auf — jede trägt ihr Positionslabel, ihre Ausrichtung und die dieser Karte in dieser Ausrichtung zugeordnete Bedeutung. Der Seed ist das Herzstück des Designs: Lassen Sie ihn weg, und der Server erzeugt einen für Sie und gibt ihn zurück; übergeben Sie ihn, und Sie erzeugen eine identische Ziehung erneut, was Legungen teilbar, testbar und prüfbar macht. Die allowReversed-Markierung entscheidet, ob Umkehrungen überhaupt möglich sind. Andere Legungen — Einzelkarte, Keltisches Kreuz, Hufeisen, Beziehung und Jahresvorschau — sind Geschwister-Endpunkte, die vom selben Deck und Seeding-Mechanismus angetrieben werden.
POST/v1/tarot/rider-waite/draw/three-card
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"question": "How will my new project unfold?"
}'{
"ok": true,
"data": {
"spread": {
"slug": "three-card",
"name": "Three Card",
"cardCount": 3
},
"seed": 4044793529,
"drawn": [
{
"position": {
"index": 0,
"name": "Past"
},
"card": {
"slug": "knight-of-wands",
"name": "Knight of Wands"
},
"reversed": false,
"meaning": "…"
}
]
}
}Parameter
| name | type | Erforderlich | |
|---|---|---|---|
| question | string | nein | An optional free-text question to associate with the reading; it is recorded with the draw but does not alter which cards are dealt. |
| seed | number | nein | An optional integer that fixes the shuffle; pass the seed from a prior response to regenerate an identical draw. |
| allowReversed | boolean | nein | An optional boolean (default true) that controls whether cards may appear reversed; set false to draw upright cards only. |
Wann verwenden
Greifen Sie hierzu, wenn Sie eine Tarot-Legung möchten, die Sie nach Bedarf reproduzieren können, statt einer einmaligen Zufallsziehung. Erfassen Sie den zurückgegebenen Seed, und Sie können später genau dieselben drei Karten erneut rendern — in einem geteilten Link, einer gespeicherten Legung, einem Regressionstest oder einem Support-Ticket — ohne die Kartenliste selbst speichern zu müssen. Verwenden Sie einen festen Seed in Tests, damit Ihre UI und Ihr Text deterministisch rendern, und lassen Sie den Server in der Produktion einen frischen Seed prägen, um echte Vielfalt zu erhalten. Greifen Sie speziell zur Drei-Karten-Legung, wenn Sie eine kompakte Struktur im Stil von Vergangenheit/Gegenwart/Zukunft möchten; wechseln Sie zu einem Geschwister-Endpunkt, wenn eine Auslage mit mehr Positionen besser zur Erfahrung passt.
Hinweise
Die Kartenbilder stammen aus dem Rider-Waite-Smith-Deck (A. E. Waite & Pamela Colman Smith, 1909), das gemeinfrei ist. Setzen Sie allowReversed auf false, um nur aufrechte Karten zu ziehen — nützlich für anfängerfreundliche Legungen, bei denen umgekehrte Bedeutungen Verwirrung stiften würden. Derselbe Seed reproduziert eine Ziehung nur für dieselbe Legung und dieselbe allowReversed-Einstellung.
Drei-Karten-Legung-API ausprobieren
Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.