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

Tarot

Üç deste: Rider-Waite-Smith (78 kart), Marsilya Tarosu (78) ve Lenormand (36). Her kart her tarot yanıtında bir görsele sahiptir ve POST /v1/interpret/tarot dağıtımı yorumlamaya dönüştürür: her pozisyon bağlamında, tüm dağıtımın özeti ve bir tavsiye.

Kart Görünümünü Seç

Section titled “Kart Görünümünü Seç”

GET /v1/tarot/decks endpointi her desteyi, onun dağıtımlarını ve görsel setlerini döndürür; bunlar herhangi bir tarot rotasına art olarak POST gövdesinde veya GET sorgu parametresi olarak ?art= ile gönderilebilir. Tüm setler kamu malı olup CDN’imizden sunulur.

DestesiartKart Sayısı
Rider-Waite-Smithrws-1909 (tipovo), rws-restored, rws-vector78
Marsilya Tarosuarnoult-174878
Lenormanddondorf35/36, Ay olmadan

Her kart urlSmall (300 px genişlik, sayfada yaklaşık 150 px olan kartlar için), url (600 px), url2x (1200 px), width, height ve art içeren bir image alır. Dağıtım ayrıca back, kartın sırt yüzünü döndürerek kartları önce yüzü aşağı göstermek için döndürür. Başka bir destenin art değeri 400 INVALID_ART hatası verir ve izin verilenlerin listesiyle birlikte gelir. Bir sete görsel olmayan kart (Lenormand’deki Ay) bu setin missing listesinde belirtilir ve image olmadan gelir; bu yüzden onu için metin kartını göster.

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

Dağıtım POST /v1/tarot/rider-waite/draw/three-card 10 kredi ile ücretlendirilir.

Model Olmayan Kart Metinleri

Section titled “Model Olmayan Kart Metinleri”

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk endpointi anahtar gerektirmeden çalışır ve her kart için description alanını üç paragraf (görsel, doğrudan anlam, ters çevrilmiş anlam) ve love, career, finance, health, spirit için upright ve reversed metinleriyle birlikte döndürür; ayrıca lokalize edilmiş name ve her taraf için en fazla beş keyword içerir. cards parametresi verilmezse tüm 78 kart döner. Metinler değişmediği için sayfada gösterilen kartları indir ve önbelleğe al.

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

Tüm Dağıtımın Yorumu

Section titled “Tüm Dağıtımın Yorumu”

POST /v1/interpret/tarot endpointi desteyi, dağıtımı, kartları ve opsiyonel soruyu alır ve language parametresiyle belirtilen dilde (21 dil) yorum üretir. Kartlar { "slug", "reversed" } objeleri olarak, veya bir dağıtım yanıtının drawn dizisi olarak değişiklik yapmadan 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);

Yanıtta positions[] (pozisyon, image içeren kart, reversed, reading), synthesis, advice ve disclaimer bulunur. Rider-Waite-Smith kartları ayrıca nameLocalized ve positionLocalized alanlarını yorum dilinde içerir. Yorum 100 kredi (Tier 4) ücretindedir ve Free planında kullanılabilir; kendi model anahtarınızla daha ucuz olur, bak. Model Anahtarınız.

Yardımcı oldu mu?
Düzenleme öner

Son güncelleme: