タロットAPI

オプションの質問とオプションのシードを与えられると、エンドポイントは三枚カードレイアウトのために、78枚のフルデッキからカードを引き、各カードは定義された位置に着地し、正位置または逆位置のいずれかで向き付けられます。応答はスプレッド自体を説明し、使用された整数シードを繰り返し、そして引かれたカードのリストを示します - 各カードは位置ラベル、向き、そしてその向きでのカードに付随する意味を持っています。シードは設計の核心です：省略するとサーバーがあなたのために生成して返し、提供すると同一の引き直しを生成し、これにより読み取りが共有可能、テスト可能、監査可能になります。allowReversedフラグは逆位置が可能かどうかを決定します。その他のスプレッド - 一枚カード、ケルトクロス、蹄鉄、関係、年間予測 - は同じデッキとシードメカニズムによって駆動される兄弟エンドポイントです。

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": "…"
      }
    ]
  }
}

このエンドポイントは、ワンオフのランダムな引きではなく、オンデマンドで再現可能なタロット読み取りを望む場合に使用します。返されたシードをキャプチャすれば、後で共有リンク、保存された読み取り、回帰テスト、またはサポートチケットで、カードリストを自分で保存することなく、まったく同じ三枚のカードを再レンダリングできます。テストでは固定シードを使用してUIとコピーが決定的にレンダリングされるようにし、本番環境ではサーバーに新鮮なシードを発行させて本物の多様性を得てください。コンパクトな過去/現在/未来スタイルの構造を望む場合は特に三枚カードスプレッドを使用し、より多くの位置を持つレイアウトが体験に適している場合は兄弟エンドポイントに切り替えてください。

カードのイメージはパブリックドメインにあるライダー・ウェイト・スミスデッキ（A. E. Waite & Pamela Colman Smith, 1909）です。allowReversedをfalseに設定すると、逆位置の意味が混乱を招く初心者向けの読み取りに役立つ、正位置のカードのみを引きます。同じシードは、同じスプレッドと同じallowReversed設定でのみ引きを再現します。