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"}'
Un tirage nommé dont chaque position porte un libellé.
Six dispositions, de la carte unique à la croix celtique de dix cartes — ainsi que passé/présent/futur, situation/action/résultat, un tirage relationnel de cinq cartes et le fer à cheval de sept cartes.
Tout l’intérêt est dans les libellés. Trois cartes sans libellé ne sont que trois cartes ; « Passé, Présent, Futur » est une lecture. Chaque carte est renvoyée avec la position où elle est tombée et ce que cette position représente.
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.
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.