curl -X POST https://api.occultapi.com/api/astro/tarot/yes-no/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"Should I take the offer?","seed":"sample-yesno"}'
किसी प्रश्न पर निकाला गया एक कार्ड, जिसे हाँ, ना या शायद के रूप में पढ़ा जाता है।
उत्तर कैसे तय होता है, यह छिपाया नहीं जाता, साफ़ बताया जाता है, क्योंकि हर रीडर की परिपाटी अलग होती है और अकेला “हाँ” यह नहीं बताता कि वह किस परिपाटी से आया। हर कार्ड का एक पारंपरिक झुकाव है — सूर्य और प्यालों का इक्का हाँ की ओर, मीनार और नौ तलवारें ना की ओर, और दो तलवारें व सात प्याले दुविधा वाले। उल्टा कार्ड हाँ को ना और ना को हाँ कर देता है; दुविधा वाला कार्ड सीधा हो या उल्टा, दुविधा वाला ही रहता है। केवल सीधे कार्ड पढ़ने हों तो `allow_reversed` को false रखें।
नतीजे के साथ कार्ड और उसके पूरे कीवर्ड भी मिलते हैं, क्योंकि अकेला “ना” कोई रीडिंग नहीं है, अर्थ तो कार्ड में होता है।
हर उत्तर में वह `seed` होता है जिससे वह ड्रॉ बना, और वही seed वापस भेजने पर ड्रॉ हूबहू दोहराया जाता है — वही कार्ड, वही क्रम, वही दिशा (सीधा या उल्टा)। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए डिफ़ॉल्ट रूप से हर बार नया ड्रॉ होता है, और बाद में उसे दोहराया भी जा सकता है। इसी से क्लाइंट कोई रीडिंग सहेजकर दोबारा दिखा सकता है, और प्रश्नकर्ता को एक ही प्रश्न का अलग उत्तर नहीं मिलता।
अनुरोध के फ़ील्ड
फ़ील्ड
टाइप
ज़रूरी
टिप्पणी
allow_reversed
boolean
वैकल्पिक
कार्ड उल्टे आ सकते हैं या नहीं। कुछ रीडर केवल सीधे कार्ड पढ़ते हैं।
question
string
वैकल्पिक
वैकल्पिक। उत्तर में वापस आता है, और नया seed बनाने में भी इसका इस्तेमाल होता है।
reversal_chance
number (double)
वैकल्पिक
उल्टे कार्ड आने की संभावना, जब उल्टे कार्डों की अनुमति हो।
min 0 · max 1
seed
string
वैकल्पिक
किसी ड्रॉ को हूबहू दोहराने के लिए उसका seed भेजें। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए कोई भी ड्रॉ बाद में दोहराया जा सकता है।