POST/api/astro/tarot/yes-no/1 kredi

Tarot evet/hayır

Bir soru için çekilen tek kart; yanıt evet, hayır veya belki olarak yorumlanır. Yanıtın nasıl belirlendiği örtük bırakılmaz, açıkça belirtilir; çünkü yorumcuların kuralları farklıdır ve tek başına bir "yes", hangi kuralla üretildiğini gizler. Her kartın geleneksel bir eğilimi vardır: Güneş ve Kupa Ası evete, Kule ve Kılıç Dokuzlusu hayıra eğilimlidir; Kılıç İkilisi ve Kupa Yedilisi kararsızdır. Ters gelen kart evet yanıtını hayıra, hayır yanıtını evete çevirir; kararsız bir kart hangi yönde gelirse gelsin kararsız kalır. Yalnızca düz kartlarla yorum için `allow_reversed` değerini false yapın. Sonuçla birlikte kart ve tüm anahtar kelimeleri de döner, çünkü tek başına bir "no" yorum sayılmaz; anlamı taşıyan karttır. 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/yes-no/

İ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.

Örnek istek

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

Yanıt

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

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.