सीधे सामग्री पर जाएँ
POST/api/astro/tarot/draw/1 क्रेडिट

टैरो ड्रॉ

फेंटे गए, अठहत्तर कार्ड वाले Rider-Waite-Smith डेक से कार्ड निकालें। निकाला गया कार्ड डेक में वापस नहीं रखा जाता, इसलिए एक ड्रॉ में कोई कार्ड दोबारा नहीं आता। हर कार्ड के साथ उसका आर्काना, सूट, रैंक, संख्या, दिशा, और जिस रूप में वह निकला उसके मानक कीवर्ड मिलते हैं। हर उत्तर में वह `seed` होता है जिससे वह ड्रॉ बना, और वही seed वापस भेजने पर ड्रॉ हूबहू दोहराया जाता है — वही कार्ड, वही क्रम, वही दिशा (सीधा या उल्टा)। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए डिफ़ॉल्ट रूप से हर बार नया ड्रॉ होता है, और बाद में उसे दोहराया भी जा सकता है। इसी से क्लाइंट कोई रीडिंग सहेजकर दोबारा दिखा सकता है, और प्रश्नकर्ता को एक ही प्रश्न का अलग उत्तर नहीं मिलता। `allow_reversed` और `reversal_chance` इसलिए हैं क्योंकि हर रीडर का तरीका अलग होता है: कुछ केवल सीधे कार्ड पढ़ते हैं, कुछ लगभग आधे डेक को उल्टा रखते हैं, और कुछ इससे बहुत कम।

https://api.occultapi.com/api/astro/tarot/draw/
अनुरोध आज़माएँ

ऑथेंटिकेशन

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

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

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

फ़ील्डटाइपज़रूरीटिप्पणी
allow_reversedbooleanवैकल्पिक

कार्ड उल्टे आ सकते हैं या नहीं। कुछ रीडर केवल सीधे कार्ड पढ़ते हैं।

countintegerवैकल्पिक

कितने कार्ड निकालने हैं, अधिकतम 21। निकाला गया कार्ड वापस नहीं रखा जाता, इसलिए कोई कार्ड दोहराया नहीं जाता।

min 1 · max 21

questionstringवैकल्पिक

वैकल्पिक। उत्तर में वापस आता है, और नया seed बनाने में भी इसका इस्तेमाल होता है।

reversal_chancenumber (double)वैकल्पिक

उल्टे कार्ड आने की संभावना, जब उल्टे कार्डों की अनुमति हो।

min 0 · max 1

seedstringवैकल्पिक

किसी ड्रॉ को हूबहू दोहराने के लिए उसका seed भेजें। seed न भेजें तो नया seed बनाकर लौटा दिया जाता है, इसलिए कोई भी ड्रॉ बाद में दोहराया जा सकता है।

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

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

उत्तर

{
  "data": {
    "question": "What should I focus on this month?",
    "seed": "sample-draw",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 50,
        "name": "Ace of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ace",
        "number": 1,
        "element": "air",
        "upright": "clarity, breakthrough, truth cutting through",
        "reversed": "confusion, a truth misused",
        "orientation": "reversed",
        "meaning": "confusion, a truth misused",
        "yes_no": "no"
      },
      {
        "position": 2,
        "id": 32,
        "name": "Page of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Page",
        "number": 11,
        "element": "fire",
        "upright": "curiosity, an idea, enthusiasm",
        "reversed": "unfocused energy, an idea unformed",
        "orientation": "reversed",
        "meaning": "unfocused energy, an idea unformed",
        "yes_no": "no"
      },
      {
        "position": 3,
        "id": 31,
        "name": "Ten of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Ten",
        "number": 10,
        "element": "fire",
        "upright": "burden, overload, carrying too much",
        "reversed": "putting a load down, delegation",
        "orientation": "upright",
        "meaning": "burden, overload, carrying too much",
        "yes_no": "no"
      }
    ],
    "count": 3
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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