Göndermek için yukarıya bir API anahtarı yapıştırın.
Kod örneği
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"}'
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ı.
İ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.
