POST/api/astro/tarot/draw/1 Credit

Tarot-Ziehung

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.

https://api.occultapi.com/api/astro/tarot/draw/

Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

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.

Beispielanfrage

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

Antwort

{
  "data": {
    "question": "What should I focus on this month?",
    "seed": "sample-draw",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 50,
        "name": "Ace of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ace",
        "number": 1,
        "element": "air",
        "upright": "clarity, breakthrough, truth cutting through",
        "reversed": "confusion, a truth misused",
        "orientation": "reversed",
        "meaning": "confusion, a truth misused",
        "yes_no": "no"
      },
      {
        "position": 2,
        "id": 32,
        "name": "Page of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Page",
        "number": 11,
        "element": "fire",
        "upright": "curiosity, an idea, enthusiasm",
        "reversed": "unfocused energy, an idea unformed",
        "orientation": "reversed",
        "meaning": "unfocused energy, an idea unformed",
        "yes_no": "no"
      },
      {
        "position": 3,
        "id": 31,
        "name": "Ten of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Ten",
        "number": 10,
        "element": "fire",
        "upright": "burden, overload, carrying too much",
        "reversed": "putting a load down, delegation",
        "orientation": "upright",
        "meaning": "burden, overload, carrying too much",
        "yes_no": "no"
      }
    ],
    "count": 3
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.