/api/astro/tarot/yes-no/1 CreditTarot: 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/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/jsonFelder 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. |
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.