API Documentation

API Endpoints

Khám phá các API endpoints có sẵn để tích hợp Tarot Reader vào ứng dụng của bạn.

GET /api/cardsGet all cards

Trả về danh sách tất cả 78 lá bài Tarot với thông tin chi tiết.

GET /api/cards/onecardGet one random card

Trả về một lá bài Tarot ngẫu nhiên từ bộ bài 78 lá.

GET /api/cards/threecardsGet three random cards

Trả về ba lá bài Tarot ngẫu nhiên, không trùng lặp, phù hợp cho trải bài 3 lá.

GET /api/quotesGet all quotes

Trả về danh sách tất cả các câu nói truyền cảm hứng với thông tin chi tiết.

GET /api/quotes/dailyGet quote of the day

Trả về câu nói của ngày hôm nay. Mỗi ngày sẽ có cùng một câu nói dựa trên ngày trong năm.

GET /api/book-of-answersGet Book of Answers response

Trả về một câu trả lời ngẫu nhiên từ cuốn sách "Vị Thần Của Những Quyết Định".

Response Format

Card Endpoints trả về dữ liệu dưới dạng JSON:

{
  "name": "The Fool",
  "image": "/tarotdeck/thefool.jpeg",
  "description": "..."
}

GET /api/quotes trả về:

{
  "quotes": [
    {
      "id": 1,
      "text": "Không ai sống hộ cuộc đời mình...",
      "category": "life"
    },
    ...
  ],
  "total": 503
}

GET /api/quotes/daily trả về:

{
  "quote": "Không ai sống hộ cuộc đời mình...",
  "category": "life",
  "id": 1,
  "date": "2025-01-21"
}

GET /api/book-of-answers trả về:

{
  "answer": "Hãy làm ngay đi"
}