curl -X POST https://api.occultapi.com/api/astro/tarot/draw/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"What should I focus on this month?","count":3,"seed":"sample-draw"}'
Zieht Karten aus einem gemischten Rider-Waite-Smith-Deck mit achtundsiebzig Karten.
Die Karten werden ohne Zurücklegen gezogen, eine Ziehung enthält also nie dieselbe Karte zweimal. Jede Karte wird mit Arkana, Farbe, Rang, Nummer, Ausrichtung und den Standard-Schlüsselwörtern für ihre Lage geliefert.
Jede Antwort enthält den `seed`, der sie erzeugt hat, und wenn du diesen Seed zurücksendest, wird die Ziehung exakt reproduziert – dieselben Karten, dieselbe Reihenfolge, dieselbe Ausrichtung. Lässt du ihn weg, wird einer erzeugt und zurückgegeben; standardmäßig gibt es also eine neue Ziehung, und sie lässt sich danach jederzeit wiederholen. So kann ein Client eine Legung speichern und erneut anzeigen, statt dem Fragesteller auf dieselbe Frage eine andere Antwort zu geben.
`allow_reversed` und `reversal_chance` gibt es, weil Kartenleger unterschiedlich arbeiten: manche nur mit aufrechten Karten, manche drehen etwa das halbe Deck um, manche deutlich weniger.
Felder der Anfrage
Feld
Typ
Pflicht
Hinweise
allow_reversed
boolean
optional
Ob Karten umgekehrt erscheinen können. Manche Kartenleger arbeiten nur mit aufrechten Karten.
count
integer
optional
Anzahl der zu ziehenden Karten, höchstens 21. Die Karten werden ohne Zurücklegen gezogen, daher kann sich keine wiederholen.
min 1 · max 21
question
string
optional
Optional. Wird unverändert zurückgegeben und fließt in einen erzeugten Seed ein.
reversal_chance
number (double)
optional
Wahrscheinlichkeit einer Umkehrung, wenn Umkehrungen erlaubt sind.
min 0 · max 1
seed
string
optional
Sende einen Seed, um eine Ziehung exakt zu reproduzieren. Lässt du ihn weg, wird einer erzeugt und zurückgegeben, sodass sich jede Ziehung danach wiederholen lässt.
