POST/api/astro/tarot/draw/1 crédit

Tirage de tarot

Tire des cartes dans un jeu Rider-Waite-Smith mélangé de soixante-dix-huit cartes. Les cartes sont tirées sans remise : une même carte ne sort donc jamais deux fois dans un tirage. Chacune est renvoyée avec son arcane, sa couleur, son rang, son numéro, son orientation et les mots-clés standard correspondant au sens dans lequel elle est sortie. 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. `allow_reversed` et `reversal_chance` existent parce que les pratiques varient d’un lecteur à l’autre : certains ne travaillent qu’à l’endroit, d’autres renversent environ la moitié du jeu, d’autres beaucoup moins.

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

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.
count	integer	facultatif	Nombre de cartes à tirer, 21 au maximum. Les cartes sont tirées sans remise : aucune ne peut donc se répéter. min 1 · max 21
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/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"}'

Réponse

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

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.