Tarot API

Dengan pertanyaan opsional dan seed opsional, endpoint ini menarik kartu dari dek lengkap 78 kartu untuk tata letak tiga kartu, tiap kartu ditempatkan pada posisi yang ditentukan dan berorientasi tegak atau terbalik. Responsnya menjelaskan penyebaran itu sendiri, mengulang seed integer yang dipakai, dan mencantumkan kartu yang ditarik - masing-masing dengan label posisi, orientasi, dan makna kartu pada orientasi itu. Seed adalah inti desain: bila tidak disertakan, server akan membuatkan satu untukmu dan mengembalikannya; bila disertakan, kamu akan menghasilkan penarikan yang identik, sehingga bacaan bisa dibagikan, diuji, dan diaudit. Flag allowReversed menentukan apakah pembalikan diperbolehkan. Penyebaran lain - satu kartu, Celtic Cross, horseshoe, hubungan, dan tahun ke depan - adalah endpoint saudara yang memakai dek dan mekanisme seeding yang sama.

curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "question": "How will my new project unfold?"
}'

{
  "ok": true,
  "data": {
    "spread": {
      "slug": "three-card",
      "name": "Three Card",
      "cardCount": 3
    },
    "seed": 4044793529,
    "drawn": [
      {
        "position": {
          "index": 0,
          "name": "Past"
        },
        "card": {
          "slug": "knight-of-wands",
          "name": "Knight of Wands"
        },
        "reversed": false,
        "meaning": "…"
      }
    ]
  }
}

Gunakan ini ketika kamu ingin bacaan tarot yang bisa kamu reproduksi kapan saja, bukan hanya penarikan acak sekali. Simpan seed yang dikembalikan dan kamu bisa menampilkan kembali tiga kartu yang sama nanti - lewat tautan bersama, bacaan tersimpan, tes regresi, atau tiket dukungan - tanpa harus menyimpan daftar kartu sendiri. Pakai seed tetap dalam tes supaya UI dan teksmu tampil deterministik, dan biarkan server membuat seed baru di produksi untuk variasi nyata. Pilih penyebaran tiga kartu khususnya ketika kamu mau struktur singkat masa lalu/sekarang/masa depan; beralih ke endpoint lain bila tata letak dengan lebih banyak posisi lebih cocok.

Gambar kartu menggunakan dek Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), yang berada di domain publik. Atur allowReversed ke false untuk menarik hanya kartu tegak - berguna untuk bacaan pemula dimana makna terbalik bisa membingungkan. Seed yang sama hanya menghasilkan penarikan yang sama untuk penyebaran dan pengaturan allowReversed yang sama.