curl -X POST https://api.occultapi.com/api/astro/tarot/draw/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"What should I focus on this month?","count":3,"seed":"sample-draw"}'
फेंटे गए, अठहत्तर कार्ड वाले Rider-Waite-Smith डेक से कार्ड निकालें।
निकाला गया कार्ड डेक में वापस नहीं रखा जाता, इसलिए एक ड्रॉ में कोई कार्ड दोबारा नहीं आता। हर कार्ड के साथ उसका आर्काना, सूट, रैंक, संख्या, दिशा, और जिस रूप में वह निकला उसके मानक कीवर्ड मिलते हैं।
हर उत्तर में वह `seed` होता है जिससे वह ड्रॉ बना, और वही seed वापस भेजने पर ड्रॉ हूबहू दोहराया जाता है — वही कार्ड, वही क्रम, वही दिशा (सीधा या उल्टा)। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए डिफ़ॉल्ट रूप से हर बार नया ड्रॉ होता है, और बाद में उसे दोहराया भी जा सकता है। इसी से क्लाइंट कोई रीडिंग सहेजकर दोबारा दिखा सकता है, और प्रश्नकर्ता को एक ही प्रश्न का अलग उत्तर नहीं मिलता।
`allow_reversed` और `reversal_chance` इसलिए हैं क्योंकि हर रीडर का तरीका अलग होता है: कुछ केवल सीधे कार्ड पढ़ते हैं, कुछ लगभग आधे डेक को उल्टा रखते हैं, और कुछ इससे बहुत कम।
अनुरोध के फ़ील्ड
फ़ील्ड
टाइप
ज़रूरी
टिप्पणी
allow_reversed
boolean
वैकल्पिक
कार्ड उल्टे आ सकते हैं या नहीं। कुछ रीडर केवल सीधे कार्ड पढ़ते हैं।
count
integer
वैकल्पिक
कितने कार्ड निकालने हैं, अधिकतम 21। निकाला गया कार्ड वापस नहीं रखा जाता, इसलिए कोई कार्ड दोहराया नहीं जाता।
min 1 · max 21
question
string
वैकल्पिक
वैकल्पिक। उत्तर में वापस आता है, और नया seed बनाने में भी इसका इस्तेमाल होता है।
reversal_chance
number (double)
वैकल्पिक
उल्टे कार्ड आने की संभावना, जब उल्टे कार्डों की अनुमति हो।
min 0 · max 1
seed
string
वैकल्पिक
किसी ड्रॉ को हूबहू दोहराने के लिए उसका seed भेजें। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए कोई भी ड्रॉ बाद में दोहराया जा सकता है।