API Tarot

Với một câu hỏi tùy chọn và một hạt giống tùy chọn, điểm cuối này bốc bài từ bộ bài đầy đủ 78 lá cho bố cục ba lá, với mỗi lá bài nằm ở một vị trí xác định và hướng thẳng hoặc ngược. Phản hồi mô tả chính bố cục, lặp lại hạt giống số nguyên được sử dụng, và liệt kê các lá bài được bốc - mỗi lá mang nhãn vị trí, hướng và ý nghĩa gắn với lá bài trong hướng đó. Hạt giống là trung tâm của thiết kế: bỏ qua nó và máy chủ sẽ tạo một cho bạn và trả về nó; cung cấp nó và bạn tạo lại một lần bốc giống hệt, điều này làm cho các lần đọc bài có thể chia sẻ, kiểm thử và kiểm toán. Cờ allowReversed quyết định việc đảo ngược có thể xảy ra hay không. Các bố cục khác - bài đơn, Thập tự giá Celtic, hình móng ngựa, mối quan hệ và năm tới - là các điểm cuối chị em được điều khiển bởi cùng bộ bài và cơ chế tạo hạt giống.

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

Sử dụng điểm cuối này khi bạn muốn một lần đọc bài tarot có thể tái tạo theo yêu cầu thay vì một lần bốc bài ngẫu nhiên một lần. Lưu lại hạt giống được trả về và bạn có thể hiển thị lại chính xác ba lá bài đó sau này - trong một liên kết được chia sẻ, một lần đọc bài được lưu, một bài kiểm tra hồi quy, hoặc một vé hỗ trợ - mà không cần lưu danh sách lá bài chính mình. Sử dụng một hạt giống cố định trong các bài kiểm tra để giao diện người dùng và văn bản của bạn được hiển thị một cách xác định, và để máy chủ tạo một hạt giống mới trong môi trường sản xuất để có sự đa dạng thực sự. Sử dụng bố cục ba lá cụ thể khi bạn muốn một cấu trúc kiểu quá/khiến/tương lai súc tích; chuyển sang một điểm cuối chị em khi một bố cục với nhiều vị trí phù hợp hơn với trải nghiệm.

Hình ảnh lá bài là bộ bài Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), thuộc phạm vi công cộng. Đặt allowReversed thành false để chỉ bốc các lá bài thẳng - hữu ích cho các lần đọc bài thân thiện với người mới bắt đầu, trong đó ý nghĩa ngược sẽ gây thêm nhầm lẫn. Cùng một hạt giống chỉ tái tạo lại một lần bốc bài cho cùng một bố cục và cùng cài đặt allowReversed.