Lewati ke konten
AstroWay/api v2.254.12 · id
semua sistem normal

Tarot

Tiga dek: Rider-Waite-Smith (78 kartu), Tarot Marseille (78) dan Lenormand (36). Setiap kartu dalam setiap respons tarot memiliki gambar, dan POST /v1/interpret/tarot mengubah tata letak menjadi penjelasan: setiap posisi dalam konteks, ringkasan seluruh tata letak dan satu nasihat.

Pilih gaya kartu

Section titled “Pilih gaya kartu”

GET /v1/tarot/decks mengembalikan setiap dek, tata letaknya dan kumpulan gaya yang dapat dikirim sebagai art ke setiap jalur tarot (di tubuh POST atau sebagai ?art= dalam GET). Semua kumpulan adalah aset publik dan dikirim dari CDN kami.

DeckartJumlah kartu
Rider-Waite-Smithrws-1909 (default), rws-restored, rws-vector78
Tarot Marseillearnoult-174878
Lenormanddondorf35 dari 36, tanpa Bulan

Setiap kartu menerima image dengan urlSmall (300 px lebar, untuk kartu hingga sekitar 150 px pada halaman), url (600 px), url2x (1200 px), width, height dan art. Tata letak juga mengembalikan back, baju kartu, agar halaman dapat pertama kali menampilkan kartu dengan wajah ke bawah. art dari dek lain memberikan 400 INVALID_ART dengan daftar yang diperbolehkan. Kartu yang tidak memiliki gambar dalam set (Bulan di Lenormand) ditentukan dalam missing dari set tersebut dan datang tanpa image, jadi tampilkan untuk itu kartu teks.

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

Tata letak POST /v1/tarot/rider-waite/draw/three-card biaya 10 kredit.

Teks kartu tanpa model

Section titled “Teks kartu tanpa model”

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk bekerja tanpa kunci dan mengembalikan untuk setiap kartu description dengan tiga paragraf (gambar, arti lurus, arti terbalik) dan teks tentang love, career, finance, health dan spirit untuk upright dan reversed, bersama dengan nama yang dilokalkan name dan hingga lima keywords untuk setiap sisi. Tanpa cards, semua 78 diterima. Teks tidak berubah, jadi unduh kartu yang ditampilkan halaman dan cache-nya.

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

Penjelasan seluruh tata letak

Section titled “Penjelasan seluruh tata letak”

POST /v1/interpret/tarot menerima dek, tata letak, kartu dan pertanyaan opsional serta menulis penjelasan dalam bahasa dengan language (21 bahasa). Kart dapat dikirim sebagai bagian, objek { "slug", "reversed" } atau array drawn dari mana saja respons tata letak tanpa perubahan.

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);

Dalam respons positions[] (posisi, kartu dengan image, reversed, reading), synthesis, advice dan disclaimer. Kart Rider-Waite-Smith juga memiliki nameLocalized dan positionLocalized dalam bahasa penjelasan. Penjelasan biaya 100 kredit (Tier 4) dan tersedia pada tarif Free; dengan kunci model sendiri lebih murah, lihat Kunci model Anda.

Bermanfaat?
Usulkan perbaikan

Terakhir diperbaharui: