POST/api/astro/tarot/spread/1 Credit

Tarot-Legesystem

Ein benanntes Legesystem, bei dem jede Position beschriftet ist. Sechs Legungen, von einer einzelnen Karte bis zum Keltischen Kreuz mit zehn Karten – außerdem Vergangenheit/Gegenwart/Zukunft, Situation/Handlung/Ergebnis, ein Beziehungs-Legesystem mit fünf Karten und das Hufeisen mit sieben Karten. Auf die Labels kommt es an. Drei unbeschriftete Karten sind drei Karten; „Vergangenheit, Gegenwart, Zukunft“ ist eine Deutung. Zu jeder Karte erhältst du die Position, auf die sie gefallen ist, und wofür diese Position steht. 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/spread/

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.
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.
spread	string	optional	Welches benannte Legesystem gelegt wird. `celtic_crosshorseshoeone_cardrelationshipsituationthree_card`

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/tarot/spread/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"How is this relationship placed?","spread":"three_card","seed":"sample-spread"}'

Antwort

{
  "data": {
    "question": "How is this relationship placed?",
    "seed": "sample-spread",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 51,
        "name": "Two of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Two",
        "number": 2,
        "element": "air",
        "upright": "stalemate, a decision deferred, blindfolded",
        "reversed": "the blindfold lifted, deciding",
        "orientation": "upright",
        "meaning": "stalemate, a decision deferred, blindfolded",
        "yes_no": "maybe",
        "position_name": "Past"
      },
      {
        "position": 2,
        "id": 59,
        "name": "Ten of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ten",
        "number": 10,
        "element": "air",
        "upright": "an ending, rock bottom, the worst passed",
        "reversed": "recovery, the only way is up",
        "orientation": "reversed",
        "meaning": "recovery, the only way is up",
        "yes_no": "yes",
        "position_name": "Present"
      },
      {
        "position": 3,
        "id": 30,
        "name": "Nine of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Nine",
        "number": 9,
        "element": "fire",
        "upright": "resilience, the last stretch, guarded",
        "reversed": "exhaustion, defensiveness",
        "orientation": "upright",
        "meaning": "resilience, the last stretch, guarded",
        "yes_no": "maybe",
        "position_name": "Future"
      }
    ],
    "spread": "three_card",
    "spread_name": "Past, present, future",
    "positions": [
      "Past",
      "Present",
      "Future"
    ],
    "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.