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