POST/api/astro/tarot/yes-no/1 क्रेडिट

टैरो हाँ या ना

किसी प्रश्न पर निकाला गया एक कार्ड, जिसे हाँ, ना या शायद के रूप में पढ़ा जाता है। उत्तर कैसे तय होता है, यह छिपाया नहीं जाता, साफ़ बताया जाता है, क्योंकि हर रीडर की परिपाटी अलग होती है और अकेला “हाँ” यह नहीं बताता कि वह किस परिपाटी से आया। हर कार्ड का एक पारंपरिक झुकाव है — सूर्य और प्यालों का इक्का हाँ की ओर, मीनार और नौ तलवारें ना की ओर, और दो तलवारें व सात प्याले दुविधा वाले। उल्टा कार्ड हाँ को ना और ना को हाँ कर देता है; दुविधा वाला कार्ड सीधा हो या उल्टा, दुविधा वाला ही रहता है। केवल सीधे कार्ड पढ़ने हों तो `allow_reversed` को false रखें। नतीजे के साथ कार्ड और उसके पूरे कीवर्ड भी मिलते हैं, क्योंकि अकेला “ना” कोई रीडिंग नहीं है, अर्थ तो कार्ड में होता है। हर उत्तर में वह `seed` होता है जिससे वह ड्रॉ बना, और वही seed वापस भेजने पर ड्रॉ हूबहू दोहराया जाता है — वही कार्ड, वही क्रम, वही दिशा (सीधा या उल्टा)। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए डिफ़ॉल्ट रूप से हर बार नया ड्रॉ होता है, और बाद में उसे दोहराया भी जा सकता है। इसी से क्लाइंट कोई रीडिंग सहेजकर दोबारा दिखा सकता है, और प्रश्नकर्ता को एक ही प्रश्न का अलग उत्तर नहीं मिलता।

https://api.occultapi.com/api/astro/tarot/yes-no/

अनुरोध आज़माएँ

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
allow_reversed	boolean	वैकल्पिक	कार्ड उल्टे आ सकते हैं या नहीं। कुछ रीडर केवल सीधे कार्ड पढ़ते हैं।
question	string	वैकल्पिक	वैकल्पिक। उत्तर में वापस आता है, और नया seed बनाने में भी इसका इस्तेमाल होता है।
reversal_chance	number (double)	वैकल्पिक	उल्टे कार्ड आने की संभावना, जब उल्टे कार्डों की अनुमति हो। min 0 · max 1
seed	string	वैकल्पिक	किसी ड्रॉ को हूबहू दोहराने के लिए उसका seed भेजें। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए कोई भी ड्रॉ बाद में दोहराया जा सकता है।

उदाहरण अनुरोध

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"}'

उत्तर

{
  "data": {
    "question": "Should I take the offer?",
    "seed": "sample-yesno",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 14,
        "name": "Temperance",
        "arcana": "major",
        "suit": null,
        "rank": null,
        "number": 14,
        "element": null,
        "upright": "balance, moderation, patience, blending",
        "reversed": "imbalance, excess, impatience",
        "orientation": "upright",
        "meaning": "balance, moderation, patience, blending",
        "yes_no": "yes"
      }
    ],
    "answer": "yes",
    "card": "Temperance",
    "orientation": "upright",
    "meaning": "balance, moderation, patience, blending",
    "how_decided": "Each card has a traditional leaning. A reversal flips yes to no and no to yes; an ambivalent card stays ambivalent. Conventions differ between readers, so this one is stated rather than left implicit."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।