İçeriğe geç
AstroWay/api v2.326.0 · tr
tüm sistemler normal

Tarot

Last updated Markdown olarak aç Aracı Kurulumu

Üç 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.

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.

KolodaartKartlar
Rider-Waite-Smithrws-1909 (varsayılan), rws-restored, rws-vector78
Marsilya Taroarnoult-174878
Lenormanddondorf36 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.

Terminal window
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.

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.

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.

Terminal window
curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'

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.