Tarot API
Bu endpoint, üç kartlık açılım için 78 kartlık Rider-Waite-Smith destesinden tohumlanmış (seeded), tekrarlanabilir bir çekim yapar. Açılım meta verilerini, karıştırmayı yöneten tam sayı seed değerini ve çekilen kartları konumları, yönleri ve anlamlarıyla birlikte döndürür - böylece seed geri verilerek herhangi bir okuma birebir tekrarlanabilir.
Tarot API
İsteğe bağlı bir soru ve isteğe bağlı bir seed verildiğinde, endpoint üç kartlık düzen için 78 kartlık destenin tamamından kartlar çeker; her kart tanımlı bir konuma ve düz ya da ters yönde yerleşir. Yanıt, açılımın kendisini tanımlar, kullanılan tam sayı seed'i yansıtır ve çekilen kartları listeler - her biri konum etiketini, yönünü ve o yöndeki anlamını taşır. Seed tasarımın kalbidir: vermezsen sunucu senin için bir tane üretir ve döndürür; verirsen birebir aynı çekimi yeniden üretirsin, bu da okumaları paylaşılabilir, test edilebilir ve denetlenebilir kılar. allowReversed bayrağı, ters kartların mümkün olup olmadığına karar verir. Diğer açılımlar - tek kart, Kelt Haçı, at nalı, ilişki ve yıl öngörüsü - aynı deste ve seed mekanizmasıyla çalışan kardeş endpoint'lerdir.
POST/v1/tarot/rider-waite/draw/three-card
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"question": "How will my new project unfold?"
}'{
"ok": true,
"data": {
"spread": {
"slug": "three-card",
"name": "Three Card",
"cardCount": 3
},
"seed": 4044793529,
"drawn": [
{
"position": {
"index": 0,
"name": "Past"
},
"card": {
"slug": "knight-of-wands",
"name": "Knight of Wands"
},
"reversed": false,
"meaning": "…"
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| question | string | no | An optional free-text question to associate with the reading; it is recorded with the draw but does not alter which cards are dealt. |
| seed | number | no | An optional integer that fixes the shuffle; pass the seed from a prior response to regenerate an identical draw. |
| allowReversed | boolean | no | An optional boolean (default true) that controls whether cards may appear reversed; set false to draw upright cards only. |
When to use it
Tek seferlik rastgele bir çekim yerine istediğinde tekrarlayabileceğin bir tarot okuması istediğinde bunu kullan. Dönen seed'i kaydet; aynı üç kartı daha sonra - paylaşılan bir bağlantıda, kayıtlı bir okumada, bir regresyon testinde veya bir destek talebinde - kart listesini kendin saklamadan birebir yeniden oluşturabilirsin. Testlerde sabit bir seed kullan ki arayüzün ve metinlerin deterministik render edilsin; gerçek çeşitlilik için üretimde sunucunun yeni bir seed üretmesine izin ver. Kompakt bir geçmiş/şimdi/gelecek tarzı yapı istediğinde özellikle üç kartlık açılımı seç; daha fazla konumlu bir düzen deneyime daha uygun olduğunda kardeş bir endpoint'e geç.
Notes
Kart görselleri, kamu malı olan Rider-Waite-Smith destesindendir (A. E. Waite & Pamela Colman Smith, 1909). Yalnızca düz kart çekmek için allowReversed değerini false yap - ters anlamların kafa karışıklığı yaratacağı, yeni başlayanlara uygun okumalar için kullanışlıdır. Aynı seed, yalnızca aynı açılım ve aynı allowReversed ayarı için aynı çekimi tekrarlar.
Try the Üç Kart Çekimi API
Grab a key and make your first call in under a minute.