Tarot API
Deze endpoint voert een gezaaid, reproduceerbare trekking uit uit de 78-kaartige Rider-Waite-Smith-deck voor de drie-kaart-spreiding. Het retourneert de spreidingsmetadata, het gehele getal dat de shuffle bepaalde, en de getrokken kaarten met hun posities, oriëntaties en betekenissen - zodat elke reading exact herhaald kan worden door de seed terug te geven.
Tarot API
Gegeens een optionele vraag en een optionele seed, trekt de endpoint kaarten uit de volledige 78-kaartige deck voor de drie-kaart-layout, met elke kaart die landt in een gedefinieerde positie en gericht ofwel recht of omgekeerd. Het antwoord beschrijft de spreiding zelf, echoot het gebruikte gehele getal als seed, en lijst de getrokken kaarten - elk met zijn positie-label, zijn oriëntatie, en de betekenis die aan die kaart in die oriëntatie is gekoppeld. De seed is het hart van het ontwerp: laat het weg en de server genereert er een voor je en geeft het terug; geef het mee en je genereert een identieke trekking, wat readings deelbaar, testbaar en controleerbaar maakt. De allowReversed-vlag bepaalt of omkeringen überhaupt mogelijk zijn. Andere spreads - enkele kaart, Keltisch Kruis, hoefijzer, relatie en vooruitblik - zijn sibling endpoints aangedreven door hetzelfde deck en dezelfde seeding-mechanisme.
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
Grijp dit aan als je een tarot-reading wilt die je op aanvraag kunt reproduceren in plaats van een eenmalige willekeurige trekking. Vang de geretourneerde seed op en je kunt later exact dezelfde drie kaarten opnieuw renderen - in een gedeelde link, een opgeslagen reading, een regressietest, of een supportticket - zonder de kaartenlijst zelf op te slaan. Gebruik een vaste seed in tests zodat je UI en kopie deterministisch renderen, en laat de server een verse seed genereren in productie voor echte variatie. Kies specifiek voor de drie-kaart-spreiding als je een compacte verleden/huidig/toekomst-achtige structuur wilt; schakel over naar een sibling endpoint als een layout met meer posities beter bij de ervaring past.
Notes
De kaartenafbeeldingen zijn van het Rider-Waite-Smith-deck (A. E. Waite & Pamela Colman Smith, 1909), dat in het publieke domein valt. Zet allowReversed op false om alleen rechtstaande kaarten te trekken - nuttig voor beginner-vriendelijke readings waar omgekeerde betekenissen verwarring zouden toevoegen. Dezelfde seed reproduceert een trekking alleen voor dezelfde spreiding en dezelfde allowReversed-instelling.
Try the Dekaartentrek API
Grab a key and make your first call in under a minute.