Juicy Fruits — tài liệu ghép client

Payline slot 5×3 + minigame Fruit Basket / Fruit Rain và jackpot 4 cấp (mini / minor / major / grand). Trang này chỉ được serve khi ENVIRONMENT != production.

1. Tổng quan

2. Luồng ghép

1. Vào game → GET /gameplay và GET /jackpot. Render board, bet, jackpot meters.
2. POST /spins với bet trong bets. Highlight win_lines.
3. Nếu is_fruit_basket_game → khóa spin, gọi POST /fruit-basket.
4. Nếu is_fruit_rain_game (từ spin hoặc sau basket) → loop POST /fruit-rain tới is_finished.
5. FS: không trừ bet, win vào pot; credit khi is_finish_free_spin.
6. Cập nhật jackpot UI từ field jackpot trên spin hoặc GET lại /jackpot.

3. Auth & envelope

Authorization: Bearer <access_token>
Content-Type: application/json

Mọi API dưới /api/v1 cần JWT. Envelope HTTP 200 + code / msg.

{
  "code": 0,
  "msg": { ... }
}

4. Grid & symbol

Board chính 5×3 (trái) và overlay Fruit Rain cùng kích thước (phải) — rain cell hiện multiplier.

Ô vàng = payline thắng. 12 = Wild. 13 = Scatter. 11 = Bonus. Rain: ×N = multiplier, MIN/GRD = jackpot.

5. GET /api/v1/jackpot

GET /api/v1/jackpot

{
  "code": 0,
  "msg": { "mini": 12000, "minor": 45000, "major": 180000, "grand": 2500000, "bet": 1000 }
}

6. GET /api/v1/gameplay

GET /api/v1/gameplay

{
  "code": 0,
  "msg": {
    "init_reels": [[8,2,0],[12,5,11],[8,9,6],[4,1,7],[13,3,10]],
    "user_money": 500000, "bet": 1000,
    "bets": [200, 1000, 2000, 10000], "show_bets": [200, 1000, 2000, 10000],
    "pay_table": [[1,2,5],[1.5,3,8],[2,4,10],[2.5,5,12],[3,8,15],[4,10,20],[5,12,25],[8,15,40],[10,25,80],[15,40,100],[20,50,150]],
    "game_type": 0, "is_free_spin": false, "free_spins": 0, "max_free_spins": 0, "free_spin_pot": 0
  }
}

7. POST /api/v1/spins

POST /api/v1/spins
{ "bet": 1000 }

WinLine

{
  "code": 0,
  "msg": {
    "user_money": 499000, "win_amount": 2500, "bet": 1000,
    "number_of_bonus_free_spins": 0, "is_free_spin": false, "free_spins": 0,
    "max_free_spins": 0, "free_spin_pot": 0, "is_finish_free_spin": false,
    "win_lines": [{ "win_amount": 2500, "line": [8,12,8,4,13], "line_number": 0, "symbol": 8, "number_of_symbols": 3 }],
    "reels": [[8,2,0],[12,5,11],[8,9,6],[4,1,7],[13,3,10]],
    "is_fruit_basket_game": true, "is_fruit_rain_game": false,
    "number_of_scatter_cols": 1, "scatter_win_amount": 0,
    "jackpot": { "mini": 12050, "minor": 45120, "major": 180400, "grand": 2500100, "bet": 1000 }
  }
}

8. POST /api/v1/fruit-basket

Chỉ gọi khi is_fruit_basket_game = true. Body rỗng.

POST /api/v1/fruit-basket

{
  "code": 0,
  "msg": { "game_type": 2, "fruit_rain_multiplier": 3, "fruit_rain_spins": 5, "number_of_bonus_free_spins": 0 }
}

9. POST /api/v1/fruit-rain

POST /api/v1/fruit-rain
{ }

Cheat non-prod có thể gửi {"jackpot": 3} (0–3 = mini…grand). Production bỏ qua.

{
  "code": 0,
  "msg": {
    "user_money": 499000, "win_amount": 3000, "bet": 1000,
    "multiplier": 3, "spins": 4, "is_finished": false,
    "rewards": [
      { "row": 0, "col": 0, "multiplier": 2, "win_amount": 2000, "jackpot": 0 },
      { "row": 0, "col": 2, "multiplier": 0, "win_amount": 12050, "jackpot": 1 }
    ],
    "jackpot_win_amount": 12050, "is_grand_jackpot": false, "is_fruit_rain_game": true
  }
}

10. Animation / flow MG

1. Spin: vẽ reels, highlight từng win_lines[].line theo line_number.
2. Hiện scatter win nếu scatter_win_amount > 0.
3. Basket: animation chọn phần thưởng → đọc multiplier / spins / FS từ response.
4. Rain: mỗi response overlay ô rewards[] (row/col). Cộng win_amount. Jackpot theo field jackpot trên reward (0 = không).
5. FS: khóa bet; tin free_spins; credit chip khi is_finish_free_spin.

11. Cheat (chỉ non-prod)

{ "bet": 1000, "reels": [[8,2,0],[12,5,11],[8,9,6],[4,1,7],[13,3,10]] }

Fruit-rain cheat: {"jackpot": 4} force grand. Production luôn random.

12. Error & tiền

13. Checklist client

• GET /gameplay (+ /jackpot) trước mọi spin.
• Board 5×3 [col][row].
• is_fruit_basket_game → /fruit-basket rồi nhánh rain/FS.
• Loop /fruit-rain tới is_finished.
• Restore rain từ fruit_rain_info.
• FS: khóa bet; credit khi is_finish_free_spin.
• Không spam song song 2 request gameplay.