타로 API

선택적 질문과 선택적 시드를 받아, 이 endpoint는 쓰리 카드 레이아웃을 위해 78장 전체 덱에서 카드를 뽑아. 각 카드는 정해진 위치에 놓이고 정방향 또는 역방향으로 배치돼. 응답은 스프레드 자체를 설명하고, 사용된 정수 시드를 그대로 돌려주며, 뽑힌 카드 목록을 제공해. 각 카드에는 위치 라벨, 방향, 그리고 해당 방향에서의 의미가 포함돼. 시드가 이 설계의 핵심이야: 생략하면 서버가 시드를 생성해서 반환하고, 제공하면 동일한 드로우를 재생성할 수 있어. 덕분에 리딩을 공유하고 테스트하고 검증할 수 있지. allowReversed 플래그는 역방향 카드가 가능한지 여부를 결정해. 다른 스프레드들(싱글 카드, 켈틱 크로스, 호스슈, 관계, 한 해 운세)은 같은 덱과 시드 메커니즘을 쓰는 형제 endpoint야.

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와 문구가 결정적으로 렌더링되게 하고, 프로덕션에서는 서버가 새 시드를 생성하게 해서 진짜 다양성을 확보해. 쓰리 카드 스프레드는 과거/현재/미래 스타일의 간결한 구조가 필요할 때 특히 적합하고, 더 많은 위치가 있는 레이아웃이 더 잘 맞으면 형제 endpoint로 전환해.

카드 이미지는 퍼블릭 도메인인 Rider-Waite-Smith 덱(A. E. Waite & Pamela Colman Smith, 1909)이야. allowReversed를 false로 설정하면 정방향 카드만 뽑히는데, 역방향 의미가 혼란을 줄 수 있는 초보자용 리딩에 유용해. 같은 시드는 같은 스프레드와 같은 allowReversed 설정에서만 동일한 드로우를 재현해.