POST/api/astro/tarot/yes-no/1 crédit

Tarot oui ou non

Une carte tirée pour une question, lue comme oui, non ou peut-être. La règle de décision est explicitée plutôt que sous-entendue, car les conventions varient d’un lecteur à l’autre et un simple "yes" ne dit pas laquelle l’a produit. Chaque carte a une tendance traditionnelle — le Soleil et l’As de Coupe penchent vers le oui, la Tour et le Neuf d’Épée vers le non, le Deux d’Épée et le Sept de Coupe sont ambivalents. Une carte renversée change un oui en non et un non en oui ; une carte ambivalente reste ambivalente dans les deux sens. Mettez `allow_reversed` à false pour ne lire que des cartes à l’endroit. La carte et tous ses mots-clés sont renvoyés avec le verdict, car un "no" seul n’est pas une lecture : c’est la carte qui porte le sens. Chaque réponse contient la graine (`seed`) qui l’a produite, et renvoyer cette graine reproduit exactement le tirage — mêmes cartes, même ordre, même sens. Si vous l’omettez, une graine est générée et renvoyée : un nouveau tirage est donc le comportement par défaut, et il reste toujours possible de le répéter ensuite. C’est ce qui permet à un client d’enregistrer une lecture et de la réafficher plutôt que de donner au consultant une réponse différente à la même question.

https://api.occultapi.com/api/astro/tarot/yes-no/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

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

Champs de la requête

Champ	Type	Obligatoire	Remarques
allow_reversed	boolean	facultatif	Autoriser les cartes renversées. Certains lecteurs ne travaillent qu’à l’endroit.
question	string	facultatif	Facultatif. Renvoyé tel quel et intégré à une graine générée.
reversal_chance	number (double)	facultatif	Probabilité d’un renversement, lorsque les renversements sont autorisés. min 0 · max 1
seed	string	facultatif	Envoyez une graine pour reproduire exactement un tirage. Si vous l’omettez, une graine est générée et renvoyée : tout tirage peut donc être répété ensuite.

Exemple de requête

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

Réponse

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

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.