API Tarot
Ce endpoint fait un tirage semé et reproductible du jeu Rider-Waite-Smith de 78 cartes pour le tirage à trois cartes. Il renvoie les métadonnées du tirage, la graine entière qui a gouverné le mélange, et les cartes tirées avec leurs positions, orientations et significations – ainsi n’importe quelle lecture peut être rejouée exactement en renvoyant la graine.
API Tarot
En fournissant une question optionnelle et une graine optionnelle, le endpoint tire des cartes du jeu complet de 78 cartes pour la disposition à trois cartes, chaque carte se plaçant à une position définie et orientée soit à l’endroit soit à l’envers. La réponse décrit le tirage lui-même, renvoie la graine entière utilisée, et liste les cartes tirées – chacune avec son libellé de position, son orientation et la signification associée à cette orientation. La graine est le cœur du design : si tu l’omet, le serveur en génère une pour toi et la renvoie ; si tu la fournis, tu recrées exactement le même tirage, ce qui rend les lectures partageables, testables et auditables. Le drapeau allowReversed décide si les renversements sont possibles. D’autres tirages – une carte, Celtic Cross, fer à cheval, relation et année à venir – sont des endpoints frères utilisant le même jeu et le même mécanisme de graine.
POST/v1/tarot/rider-waite/draw/three-card
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"question": "How will my new project unfold?"
}'{
"ok": true,
"data": {
"spread": {
"slug": "three-card",
"name": "Three Card",
"cardCount": 3
},
"seed": 4044793529,
"drawn": [
{
"position": {
"index": 0,
"name": "Past"
},
"card": {
"slug": "knight-of-wands",
"name": "Knight of Wands"
},
"reversed": false,
"meaning": "…"
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| question | string | no | An optional free-text question to associate with the reading; it is recorded with the draw but does not alter which cards are dealt. |
| seed | number | no | An optional integer that fixes the shuffle; pass the seed from a prior response to regenerate an identical draw. |
| allowReversed | boolean | no | An optional boolean (default true) that controls whether cards may appear reversed; set false to draw upright cards only. |
When to use it
Utilise ça quand tu veux une lecture de tarot que tu peux reproduire à la demande plutôt qu’un tirage aléatoire unique. Capture la graine renvoyée et tu pourras re-afficher les mêmes trois cartes plus tard – dans un lien partagé, une lecture sauvegardée, un test de régression ou un ticket de support – sans stocker toi-même la liste des cartes. Utilise une graine fixe dans les tests pour que ton UI et ton texte s’affichent de façon déterministe, et laisse le serveur créer une nouvelle graine en production pour une vraie variété. Choisis le tirage à trois cartes spécifiquement quand tu veux une structure compacte passé/présent/futur ; passe à un endpoint frère quand une disposition avec plus de positions convient mieux.
Notes
Les images des cartes proviennent du jeu Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), qui est dans le domaine public. Mets allowReversed à false pour ne tirer que des cartes à l’endroit – utile pour des lectures destinées aux débutants où les significations inversées ajouteraient de la confusion. La même graine ne reproduit un tirage que pour le même tirage et le même paramètre allowReversed.
Try the Tirage à trois cartes API
Grab a key and make your first call in under a minute.