Direkt zum Inhalt
POST/api/astro/tarot/yes-no/1 Credit

Tarot: Ja oder Nein

Eine Karte, zu einer Frage gezogen und als Ja, Nein oder Vielleicht gedeutet. Wie die Antwort zustande kommt, wird offen angegeben und nicht stillschweigend vorausgesetzt, denn Kartenleger folgen unterschiedlichen Konventionen, und ein bloßes „Ja“ verschweigt, nach welcher es entstanden ist. Jede Karte hat eine traditionelle Tendenz – die Sonne und das Ass der Kelche tendieren zu Ja, der Turm und die Neun der Schwerter zu Nein, die Zwei der Schwerter und die Sieben der Kelche sind unentschieden. Eine Umkehrung macht aus Ja ein Nein und aus Nein ein Ja; eine unentschiedene Karte bleibt in beiden Ausrichtungen unentschieden. Setze `allow_reversed` auf false, um nur aufrechte Karten zu deuten. Die Karte und ihre vollständigen Schlüsselwörter werden mit dem Urteil geliefert, denn ein „Nein“ allein ist keine Deutung – die Bedeutung trägt die Karte. 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.

https://api.occultapi.com/api/astro/tarot/yes-no/
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

FeldTypPflichtHinweise
allow_reversedbooleanoptional

Ob Karten umgekehrt erscheinen können. Manche Kartenleger arbeiten nur mit aufrechten Karten.

questionstringoptional

Optional. Wird unverändert zurückgegeben und fließt in einen erzeugten Seed ein.

reversal_chancenumber (double)optional

Wahrscheinlichkeit einer Umkehrung, wenn Umkehrungen erlaubt sind.

min 0 · max 1

seedstringoptional

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/yes-no/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Should I take the offer?","seed":"sample-yesno"}'

Antwort

{
  "data": {
    "question": "Should I take the offer?",
    "seed": "sample-yesno",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 14,
        "name": "Temperance",
        "arcana": "major",
        "suit": null,
        "rank": null,
        "number": 14,
        "element": null,
        "upright": "balance, moderation, patience, blending",
        "reversed": "imbalance, excess, impatience",
        "orientation": "upright",
        "meaning": "balance, moderation, patience, blending",
        "yes_no": "yes"
      }
    ],
    "answer": "yes",
    "card": "Temperance",
    "orientation": "upright",
    "meaning": "balance, moderation, patience, blending",
    "how_decided": "Each card has a traditional leaning. A reversal flips yes to no and no to yes; an ambivalent card stays ambivalent. Conventions differ between readers, so this one is stated rather than left implicit."
  },
  "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.