POST/api/astro/tarot/draw/1 kredi

Tarot çekimi

Karıştırılmış, yetmiş sekiz kartlık Rider-Waite-Smith destesinden kart çeker. Kartlar desteye geri konmadan çekilir; bu yüzden bir çekimde aynı kart iki kez çıkmaz. Her kart arkanası, takımı, değeri, numarası, yönü ve düştüğü yöne ait standart anahtar kelimeleriyle 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. Yorumcuların yaklaşımları farklı olduğu için `allow_reversed` ve `reversal_chance` parametreleri vardır: bazıları yalnızca düz kartlarla çalışır, bazıları destenin yaklaşık yarısını ters çevirir, bazıları çok daha azını.

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

İ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.
count	integer	isteğe bağlı	Çekilecek kart sayısı, en fazla 21. Kartlar desteye geri konmadan çekildiği için hiçbir kart tekrar etmez. min 1 · max 21
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.

Örnek istek

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

Yanıt

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

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.