Tarot
Üç taro kolodu: Rider-Waite-Smith (78 kart), Marsilya Taro (78) ve Lenormand (36). Her bir kartanın her birinde resim vardır ve POST /v1/interpret/tarot bir taro okuması yapar: her pozisyonun kontekste açıklaması, tüm okumanın özeti ve bir tavsiye verir.
Kartların Stillerini Seçin
Section titled “Kartların Stillerini Seçin”GET /v1/tarot/decks her kolodunun, okuma stillerini ve taro yollarına (POST gövdesinde veya ?art= olarak GET’te) gönderilebilecek stil setlerini döndürür. Tüm stiller kamu malıdır ve CDN’den sağlanır.
| Koloda | art | Kartlar |
|---|---|---|
| Rider-Waite-Smith | rws-1909 (varsayılan), rws-restored, rws-vector | 78 |
| Marsilya Taro | arnoult-1748 | 78 |
| Lenormand | dondorf | 36 karttan 35’i (Ay hariç) |
Her kart image alanını urlSmall (300 px genişlik, sayfada yaklaşık 150 px’ye kadar kartlar için), url (600 px), url2x (1200 px), width, height ve art ile döndürür. Okuma ayrıca back (kartın arka yüzü) döndürür, böylece sayfa öncelikle kartların arka yüzünü gösterebilir. Başka bir kolodanın art parametresi 400 INVALID_ART hatası ile geçerli stillerin listesi döndürür. Stil setinde resim bulunmayan kart (Lenormand’daki Ay) missing alanında belirtilir ve image olmadan döndürülür, bu nedenle bu kart için metin kartı gösterin.
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \ -H "X-Api-Key: aw_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "seed": 12345, "art": "rws-restored" }'{ "drawn": [ { "position": { "index": 0, "name": "Past", "meaning": "Forces from the past shaping the situation." }, "card": { "slug": "8-of-pentacles", "name": "Eight of Pentacles", "image": { "url": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles.webp", "url2x": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles@2x.webp", "urlSmall": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles-300.webp", "width": 600, "height": 1028, "art": "rws-restored" } }, "reversed": false } ], "back": { "url": "https://cdn.astroway.info/tarot/rws-1909/back.webp", "url2x": "https://cdn.astroway.info/tarot/rws-1909/back@2x.webp", "urlSmall": "https://cdn.astroway.info/tarot/rws-1909/back-300.webp", "width": 600, "height": 1039, "art": "rws-1909" }}POST /v1/tarot/rider-waite/draw/three-card okuması 10 kredi maliyetlidir.
Kendi Okumanız ve Lenormand Çiftleri
Section titled “Kendi Okumanız ve Lenormand Çiftleri”POST /v1/tarot/rider-waite/draw/custom, /tarot/marseille/draw/custom ve /tarot/lenormand/draw/custom 1 ila 15 kartı, sizin belirlediğiniz pozisyonlarda (positions: ["Ben", "Sen", "Biz"]) veya sadece count kartı yerleştirir. Karıştırma hazır okumalardakine benzerdir, bu nedenle aynı seed ile üç kartlı kendi okumanız hazır okumadaki üç kartla eşleşir.
POST /v1/tarot/lenormand/combination iki Lenormand kartını bir çift olarak okur: İlk kart bir konuyu, ikinci kart onu tanımlar, bu nedenle sıralama önemlidir ({ "cards": ["heart", "ring"] } “Aşk ve his, sözleşmeyle bağlı.” cümlesini verir). Cevap ayrıca çiftin ters sıralı okumasını ve çiftin genel tonunu içerir. Her kartın ana anlamlarından yazılan cümlelerdir, çiftler tablosu hiçbir yerden kopyalanmamıştır. Her biri 10 kredi maliyetlidir.
Bir kart için evet/hayır cevabı zaten mevcuttur: POST /v1/tarot/rider-waite/draw/decision ve /tarot/marseille/draw/decision verdict (yes, no, maybe) ve nedenini döndürür.
Model Olmadan Kart Metinleri
Section titled “Model Olmadan Kart Metinleri”GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=tr anahtarsız çalışır ve her kart için description (üç paragraf: resim, doğrultu anlamı, ters anlamı) ve love, career, finance, health ve spirit için upright ve reversed durumlar için metinler döndürür. Ayrıca, okuma diline göre yerelleştirilmiş name ve her iki taraf için beş keywords içerir. cards parametresi verilmezse tüm 78 kart döndürülür. Metinler değiştirilmez, bu nedenle sayfada gösterilen kartları indirin ve onları önbelleğe alın.
curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'Tüm Okumanın Yorumlanması
Section titled “Tüm Okumanın Yorumlanması”POST /v1/interpret/tarot kolodu, okuma, kartları ve isteğe bağlı bir soruyu alır ve language (21 dil) dilinde yorum yazar. Kartlar parçalar, { "slug", "reversed" } nesneleri veya herhangi bir okuma cevabından değiştirilmeden alınan drawn dizisi olarak gönderilebilir.
const headers = { 'Content-Type': 'application/json', 'X-Api-Key': process.env.ASTROWAY_API_KEY };const api = (path, body) => fetch(`https://api.astroway.info/v1${path}`, { method: 'POST', headers, body: JSON.stringify(body) }).then((r) => r.json());
const { data: spread } = await api('/tarot/rider-waite/draw/three-card', { art: 'rws-1909' });const { data: reading } = await api('/interpret/tarot', { spread: 'three-card', question: 'What should I focus on at work?', cards: spread.drawn, language: 'en',});
for (const p of reading.positions) { console.log(p.position, p.card.name, p.reversed ? '(reversed)' : '', p.card.image.url); console.log(' ', p.reading);}console.log('Summary:', reading.synthesis);Cevapta positions[] (pozisyon, image, reversed, reading), synthesis, advice ve disclaimer bulunur. Rider-Waite-Smith kartları ayrıca yorum diline göre nameLocalized ve positionLocalized içerir. Yorum 100 kredi (Tier 4) maliyetlidir ve Free aboneliğiyle kullanılabilir; kendi model anahtarıyla daha ucuzdur, Kendi Model Anahtarı için bakınız.