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

टैरो स्प्रेड

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

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

ऑथेंटिकेशन

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

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

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

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

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

questionstringवैकल्पिक

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

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

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

min 0 · max 1

seedstringवैकल्पिक

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

spreadstringवैकल्पिक

कौन-सा स्प्रेड बिछाना है (नाम से)।

celtic_crosshorseshoeone_cardrelationshipsituationthree_card

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

curl -X POST https://api.occultapi.com/api/astro/tarot/spread/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"How is this relationship placed?","spread":"three_card","seed":"sample-spread"}'

उत्तर

{
  "data": {
    "question": "How is this relationship placed?",
    "seed": "sample-spread",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 51,
        "name": "Two of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Two",
        "number": 2,
        "element": "air",
        "upright": "stalemate, a decision deferred, blindfolded",
        "reversed": "the blindfold lifted, deciding",
        "orientation": "upright",
        "meaning": "stalemate, a decision deferred, blindfolded",
        "yes_no": "maybe",
        "position_name": "Past"
      },
      {
        "position": 2,
        "id": 59,
        "name": "Ten of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ten",
        "number": 10,
        "element": "air",
        "upright": "an ending, rock bottom, the worst passed",
        "reversed": "recovery, the only way is up",
        "orientation": "reversed",
        "meaning": "recovery, the only way is up",
        "yes_no": "yes",
        "position_name": "Present"
      },
      {
        "position": 3,
        "id": 30,
        "name": "Nine of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Nine",
        "number": 9,
        "element": "fire",
        "upright": "resilience, the last stretch, guarded",
        "reversed": "exhaustion, defensiveness",
        "orientation": "upright",
        "meaning": "resilience, the last stretch, guarded",
        "yes_no": "maybe",
        "position_name": "Future"
      }
    ],
    "spread": "three_card",
    "spread_name": "Past, present, future",
    "positions": [
      "Past",
      "Present",
      "Future"
    ],
    "count": 3
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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