POST/api/astro/tarot/spread/1 kredi

Tarot açılımı

Tüm pozisyonları etiketlenmiş, adı olan bir açılım. Tek karttan on kartlık Kelt Haçı'na kadar altı düzen; bunlar arasında geçmiş/şimdi/gelecek, durum/eylem/sonuç, beş kartlık ilişki açılımı ve yedi kartlık at nalı da var. Asıl önemli olan etiketlerdir. Etiketsiz üç kart yalnızca üç karttır; "Past, Present, Future" ise bir yorumdur. Her kart, düştüğü pozisyon ve o pozisyonun neyi temsil ettiğiyle birlikte döner. Her yanıt, kendisini üreten `seed` değerini içerir; bu seed geri gönderildiğinde çekim birebir tekrarlanır — aynı kartlar, aynı sıra, aynı yön. Seed gönderilmezse yeni bir seed üretilip yanıtta döner; böylece varsayılan olarak her seferinde yeni bir çekim yapılır, ama aynı çekimi sonradan tekrarlamak her zaman mümkündür. Bu sayede istemci bir yorumu saklayıp yeniden gösterebilir ve danışana aynı soru için farklı bir yanıt vermek zorunda kalmaz.

https://api.occultapi.com/api/astro/tarot/spread/

İsteği deneyin

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

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

İstek alanları

Alan	Tür	Zorunlu	Notlar
allow_reversed	boolean	isteğe bağlı	Kartların ters gelip gelemeyeceği. Bazı yorumcular yalnızca düz kartlarla çalışır.
question	string	isteğe bağlı	İsteğe bağlı. Yanıtta aynen geri döner ve üretilen seed değerinin hesaplanmasına katılır.
reversal_chance	number (double)	isteğe bağlı	Ters kartlara izin verildiğinde bir kartın ters gelme olasılığı. min 0 · max 1
seed	string	isteğe bağlı	Bir çekimi birebir tekrarlamak için seed gönderin. Gönderilmezse yeni bir seed üretilip yanıtta döner; böylece her çekim sonradan tekrarlanabilir.
spread	string	isteğe bağlı	Kullanılacak açılımın adı. `celtic_crosshorseshoeone_cardrelationshipsituationthree_card`

Örnek istek

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

Yanıt

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

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.