Chuyển tới nội dung chính

Tham chiếu API Công khai

Prizee LOTTERY cung cấp REST API công khai cho phép các nhà phát triển, nền tảng tổng hợp dữ liệu Web3 và các bảng điều khiển phân tích tra cứu thông tin các round xổ số, thống kê vé, kết quả quay số và bằng chứng mã hóa on-chain.

Tổng quan & Xác thực​

  • Định dạng dữ liệu: Chuẩn JSON qua giao thức bảo mật HTTPS.
  • Xác thực: Các endpoint đọc dữ liệu công khai (danh sách round, kết quả lịch sử, thông tin seed) không yêu cầu xác thực.
  • Thao tác người dùng: Các endpoint dành riêng cho người dùng (xem danh sách vé của tôi, tham gia chiến dịch) yêu cầu đính kèm Bearer token trong header:
Authorization: Bearer <auth_token>

Các Endpoint chính​

1. Rounds & Lotteries​

GET /api/lotteries​

Truy xuất danh sách tất cả các vòng chơi xổ số đang mở, sắp diễn ra và đã hoàn thành.

  • Tham số truy vấn (Query Parameters):
    • status: Lọc theo trạng thái round (scheduled, open, drawn, refunded).
    • mode: Lọc theo loại hình (rolling_jackpot, fixed_lottery, task_reward).
  • Định dạng phản hồi:
[
  {
    "id": "673abc45f89123004e12ab89",
    "code": 104,
    "title": "Genesis Jackpot #104",
    "description": "Weekly rolling jackpot on Arc Testnet",
    "creatorName": "Prizee Core",
    "drawAt": "2026-09-10T12:00:00.000Z",
    "prizePool": 2500,
    "ticketPrice": 2,
    "poolMode": "rolling_jackpot",
    "currency": "USDC",
    "status": "scheduled",
    "escrowAddress": "0x39a1...44bc"
  }
]

GET /api/lotteries/:id​

Truy xuất toàn bộ thông tin chi tiết của một round xổ số cụ thể, bao gồm điều kiện nhiệm vụ mạng xã hội, cơ cấu giải thưởng và các con số tham dự.

2. Vé số & Thông tin tham gia​

GET /api/tickets/my​

Lấy danh sách các vé số thuộc sở hữu của người dùng đã xác thực.

  • Định dạng phản hồi:
[
  {
    "id": "tkt_81726a",
    "roundId": "673abc45f89123004e12ab89",
    "numbers": [7, 14, 21, 33, 42, 51],
    "paymentTxHash": "0x892a...1234",
    "paidAmount": 2,
    "currency": "USDC",
    "createdAt": "2026-09-04T10:00:00.000Z"
  }
]

3. Kết quả quay số & Bằng chứng mã hóa​

GET /api/draws​

Trả về kết quả các lượt quay số lịch sử, dãy số trúng thưởng và danh sách thanh toán giải thưởng.

  • Định dạng phản hồi:
[
  {
    "id": "drw_554109",
    "roundCode": 104,
    "targetBlock": 1429810,
    "blockHash": "0x9f8b2c4a...77a1",
    "winningNumbers": [7, 14, 21, 33, 42, 51],
    "totalWinners": 3,
    "totalPrizePaid": 2500,
    "currency": "USDC",
    "settledAt": "2026-09-10T12:01:14.000Z"
  }
]

GET /api/draws/:id​

Trả về dữ liệu xác thực mã hóa chi tiết cho một lượt quay số cụ thể:

  • targetBlock: Chiều cao block mục tiêu được cam kết trước trên mạng Arc Network.
  • blockHash: Giá trị hash của block được khai thác.
  • seedSteps: Trình tự phân tích chi tiết từng cặp số để trích xuất ra dãy số trúng thưởng.
  • winners: Danh sách vé trúng thưởng và số tiền chi trả tương ứng.