API Tarocchi
Questo endpoint esegue un tiraggio riproducibile con seed dal mazzo di 78 carte Rider-Waite-Smith per il tiraggio di tre carte. Restituisce i metadati del tiraggio, il seed intero che ha governato il mescolamento e le carte estratte con le loro posizioni, orientamenti e significati - in modo che qualsiasi lettura possa essere riprodotta esattamente passando nuovamente il seed.
API Tarocchi
Dato una domanda opzionale e un seed opzionale, l'endpoint estrae carte dal mazzo completo di 78 carte per il layout di tre carte, con ogni carta che atterra in una posizione definita e orientata either dritta o capovolta. La risposta descrive il tiraggio stesso, ripete il seed intero usato e elenca le carte estratte - ognuna con la sua etichetta di posizione, il suo orientamento e il significato associato a quella carta in quell'orientamento. Il seed è il cuore della progettazione: omettilo e il server ne genera uno per te e lo restituisce; forniscilo e rigeneri un tiraggio identico, il che rende le letture condivisibili, testabili e verificabili. Il flag allowReversed decide se le carte capovolte sono possibili. Altri tiraggi - carta singola, Cro Celtica, ferro di cavallo, relazione e anno avanti - sono endpoint fratelli guidati dallo stesso mazzo e meccanismo di seeding.
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
Usa questo quando vuoi una lettura dei tarocchi che puoi riprodurre su richiesta invece di un estratto casuale occasionale. Cattura il seed restituito e puoi riprodurre esattamente le stesse tre carte più tardi - in un link condiviso, una lettura salvata, un test di regressione o una ticket di supporto - senza dover memorizzare tu stesso l'elenco delle carte. Usa un seed fisso nei test in modo che la tua UI e il testo vengano renderizzati in modo deterministico, e lascia che il server generi un seed fresco in produzione per una vera varietà. Scegli specificamente il tiraggio di tre carte quando vuoi una struttura compatta stile passato/presente/futuro; passa a un endpoint fratello quando un layout con più posizioni si adatta meglio all'esperienza.
Notes
L'immagine delle carte è il mazzo Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), che è di dominio pubblico. Imposta allowReversed su false per estrarre solo carte dritte - utile per letture per principianti dove i significati capovolti aggiungerebbero confusione. Lo stesso seed riproduce un estratto solo per lo stesso tiraggio e la stessa impostazione allowReversed.
Try the Tiraggio di Tre Carte API
Grab a key and make your first call in under a minute.