Tarot API
यह endpoint 78-कार्ड Rider-Waite-Smith डेक से तीन-कार्ड spread के लिए seeded, reproducible draw करता है। यह spread की metadata, shuffle को नियंत्रित करने वाला integer seed, और खींचे गए कार्ड उनके positions, orientations और meanings के साथ लौटाता है – ताकि seed वापस भेजकर कोई भी reading बिल्कुल दोहराई जा सके।
Tarot API
एक optional question और optional seed मिलने पर, endpoint पूरे 78-कार्ड डेक से तीन-कार्ड layout के लिए कार्ड ड्रॉ करता है, जहाँ हर कार्ड एक निर्धारित position में उतरता है और upright या reversed orientation में रहता है। response में spread का विवरण, उपयोग किया गया integer seed दोहराया जाता है, और ड्रॉ किए गए कार्डों की सूची होती है – प्रत्येक में उसका position label, orientation, और उस orientation में कार्ड का meaning शामिल है। seed डिजाइन का दिल है: अगर आप इसे छोड़ देते हैं तो server आपके लिए एक बनाता है और लौटाता है; अगर आप देते हैं तो वही ड्रॉ फिर से बनता है, जिससे readings shareable, testable और auditable बनते हैं। allowReversed flag तय करता है कि reversals संभव हैं या नहीं। अन्य spreads – single-card, Celtic Cross, horseshoe, relationship और year-ahead – sibling endpoints हैं जो वही डेक और 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
जब तुम्हें एक tarot reading चाहिए जो demand पर reproduce हो सके, न कि एक बार का random draw, तब इसे इस्तेमाल करो। लौटाए गए seed को पकड़ लो और बाद में वही तीन कार्ड फिर से दिखा सकते हो – एक shared link, saved reading, regression test, या support ticket में – बिना खुद कार्ड लिस्ट स्टोर किए। टेस्ट में fixed seed इस्तेमाल करो ताकि तुम्हारा UI और copy deterministic ढंग से render हो, और production में server को fresh seed mint करने दो ताकि variety मिले। खास तौर पर three-card spread तब चुनो जब तुम्हें एक compact past/present/future-style structure चाहिए; अगर ज्यादा positions वाला layout चाहिए तो sibling endpoint पर स्विच करो।
Notes
कार्ड इमेजरी Rider-Waite-Smith डेक (A. E. Waite & Pamela Colman Smith, 1909) से ली गई है, जो public domain में है। allowReversed को false सेट करो ताकि केवल upright कार्ड ड्रॉ हों – यह beginner-friendly readings के लिए उपयोगी है जहाँ reversed meanings से confusion बढ़ेगा। वही seed केवल उसी spread और उसी allowReversed सेटिंग के साथ ही ड्रॉ को reproduce करता है।
Try the तीन-कार्ड ड्रॉ API
Grab a key and make your first call in under a minute.