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

Tarot

Last updated Buka sebagai Markdown Pengaturan agen

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

GET /v1/tarot/decks mengembalikan setiap dek, pembacaannya, dan set gaya yang dapat kamu berikan sebagai art ke rute tarot mana pun (dalam body POST atau sebagai ?art= di GET). Semua set adalah domain publik dan disajikan dari CDN kami.

DekartKartu
Rider-Waite-Smithrws-1909 (default), rws-restored, rws-vector78
Marseille Tarotarnoult-174878
Lenormanddondorf35 dari 36, tanpa Bulan

Setiap kartu menerima image dengan urlSmall (lebar 300 px, untuk kartu hingga sekitar 150 px di halaman), url (600 px), url2x (1200 px), width, height, dan art. Pembacaan juga mengembalikan back, punggung kartu, sehingga halaman dapat menampilkan kartu menghadap ke bawah terlebih dahulu. art dari dek lain akan menghasilkan 400 INVALID_ART dengan daftar yang diizinkan. Kartu yang tidak memiliki gambar dalam set (Bulan di Lenormand) ditunjukkan dalam missing set tersebut dan datang tanpa image, jadi tampilkan kartu teks untuknya.

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

Pembacaan POST /v1/tarot/rider-waite/draw/three-card berharga 10 kredit.

POST /v1/tarot/rider-waite/draw/custom, /tarot/marseille/draw/custom, dan /tarot/lenormand/draw/custom menempatkan 1 hingga 15 kartu dalam posisi yang kamu namai sendiri (positions: ["Saya", "Kamu", "Kita"]), atau cukup count kartu. Pengocokan sama dengan pembacaan yang sudah jadi, jadi dengan seed yang sama, tiga kartu dari pembacaan kustom akan cocok dengan kartu three-card.

POST /v1/tarot/lenormand/combination membaca dua kartu Lenormand sebagai pasangan: yang pertama menamai subjek, yang kedua menggambarkannya, jadi urutan itu penting ({ "cards": ["heart", "ring"] } menghasilkan “Love and feeling, bound by agreement.”). Respons juga memiliki pembacaan terbalik dan nada umum pasangan tersebut. Frasa untuk setiap kartu kami tulis dari makna dasar kartu, tabel pasangan tidak disalin dari siapa pun. Masing-masing 10 kredit.

Jawaban ya/tidak untuk satu kartu sudah tersedia: POST /v1/tarot/rider-waite/draw/decision dan /tarot/marseille/draw/decision mengembalikan verdict (yes, no, maybe) dan alasannya.

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

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

POST /v1/interpret/tarot menerima dek, pembacaan, kartu, dan pertanyaan opsional, lalu menulis interpretasi dalam bahasa dari language (21 bahasa). Kartu dapat diberikan sebagai slug, objek { "slug", "reversed" }, atau array drawn dari respons pembacaan mana pun 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. Kartu Rider-Waite-Smith juga memiliki nameLocalized dan positionLocalized dalam bahasa interpretasi. Interpretasi berharga 100 kredit (Tier 4) dan tersedia pada paket Free; dengan kunci model kamu sendiri, lebih murah, lihat Kunci model kamu sendiri.