Farm Yard — tài liệu ghép client

Slot cluster 7×7. Market / storage, 3 loại buy FS (golden crop, market day, storage surplus). Client nói HTTP JSON. Trang này chỉ được serve khi ENVIRONMENT != production.

1. Tổng quan

2. Luồng ghép

1. Mở game → GET /gameplay + GET /jackpot. Render board, bet, market/storage, sticky multipliers nếu đang FS.
2. Base: POST /spins. Play tuần tự win_result[] (cluster → tumble → rush/surge/slash).
3. Nếu is_bonus_free_spin: popup +N, chuyển UI theo bonus_free_spin_type.
4. FS: không trừ bet, line win vào pot. Market/storage cập nhật từ field cùng tên. JP credit ngay.
5. Buy một trong 3 endpoint → mở FS tương ứng; sau đó mỗi lượt vẫn POST /spins.
6. is_finish_free_spin → credit pot, về base. Luôn tin user_money trên response.

3. Auth & envelope

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

Mọi API dưới /api/v1 cần JWT. HTTP 200 + code = 0 là thành công; payload trong msg.

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

4. Grid & symbol

Ô vàng = cluster thắng. Ô xanh = rush. Ô xanh lá = slash.

5. GET /api/v1/gameplay

Gọi 1 lần khi vào game — set session initiated. Thiếu bước này thì mọi spin/buy = code 69.

GET /api/v1/gameplay

{
  "code": 0,
  "msg": {
    "init_reels": [[0,1,2,3,4,5,6],[1,2,3,4,5,6,7],[2,3,4,5,6,7,0],[3,4,5,6,7,0,1],[4,5,6,7,0,1,2],[5,6,7,0,1,2,3],[6,7,0,1,2,3,4]],
    "user_money": 800000, "bet": 1000, "bets": [200,1000,2000,10000], "show_bets": [200,1000,2000,10000],
    "pay_table": [[10,25,50,100],[5,15,30,60],[3,10,20,40],[2,8,15,30],[1.5,6,12,25],[1,4,10,20],[0.8,3,8,15],[0.5,2,5,10]],
    "is_free_spin": false, "free_spins": 0, "max_free_spins": 0, "free_spin_pot": 0, "free_spin_type": 0,
    "market": 0, "storage": 0, "multipliers": [0,0,0,0,0,0,0,0],
    "golden_crop_price": 50, "market_day_price": 80, "storage_surplus_price": 120
  }
}

6. GET /api/v1/jackpot

GET /api/v1/jackpot

{ "code": 0, "msg": [{ "bet": 200, "amount": 120000 }, { "bet": 1000, "amount": 600000 }] }

7. POST /api/v1/spins

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

InitiatedRequired. Base trừ bet. FS không trừ, không đổi bet. reels chỉ cheat.

SpinResult

WinResult

{
  "code": 0,
  "msg": {
    "bet": 1000, "price": 0, "user_money": 799000, "win_amount": 4500,
    "is_free_spin": false, "free_spins": 8, "free_spin_pot": 0, "is_finish_free_spin": false,
    "is_bonus_free_spin": true, "bonus_free_spin_type": 1, "number_of_bonus_free_spins": 8,
    "free_spin_type": 1, "max_free_spins": 8, "market": 0,
    "is_jackpot": false, "jackpot_win_amount": 0, "jackpot_amount": 600000,
    "win_result": [{
      "lines": [{ "symbol": 3, "positions": [[],[1,2],[0,1,2],[1],[],[],[]], "win_amount": 4500, "line_size": 6, "multiplier": 4.5, "bonus_multiplier": 1 }],
      "reels": [[0,1,2,5,3,4,5],[1,3,3,4,5,6,7],[3,3,3,5,6,7,0],[3,3,5,6,7,0,1],[9,5,6,7,0,1,2],[5,6,7,0,1,2,3],[6,7,0,1,2,3,4]],
      "positions": [[],[1,2],[0,1,2],[1],[],[],[]], "win_amount": 4500, "total_win_amount": 4500,
      "rush": { "rush_positions": [[4],[0],[],[],[],[],[]], "positions": [[],[3],[3],[],[],[],[]] },
      "surge": [], "slash": { "slash_positions": [], "positions": [] }, "multiplier": [],
      "market": 0, "market_count": 0, "market_multiplier": 0, "storage": 0, "multipliers": [0,0,0,0,0,0,0,0]
    }]
  }
}

8. Buy FS — 3 endpoint

Cùng body {"bet": 1000}. Cấm khi đang FS → popup 1000. Buy chỉ mở FS (trừ giá, set free_spins); mỗi lượt FS vẫn POST /spins.

POST /api/v1/buy-golden-crop
{ "bet": 1000 }

{
  "code": 0,
  "msg": {
    "bet": 1000, "price": 0, "user_money": 750000, "win_amount": 0,
    "is_free_spin": false, "free_spins": 8, "free_spin_pot": 0, "is_finish_free_spin": false,
    "is_bonus_free_spin": true, "bonus_free_spin_type": 1, "number_of_bonus_free_spins": 8,
    "free_spin_type": 1, "max_free_spins": 8, "win_result": [],
    "market": 0, "is_jackpot": false, "jackpot_win_amount": 0, "jackpot_amount": 600000
  }
}

9. Tumble / special

1. Vẽ reels. Highlight cluster lines / positions.
2. Hết cluster: nếu có rush → biến rush.positions thành wild. Rồi surge, rồi slash (xóa, không cộng tiền).
3. Gravity + fill. Board mới = win_result[i+1].reels.
4. Market/storage/multipliers lấy từ field tumble + top-level, không tự tính.

10. Cheat (chỉ non-prod / cheater)

{ "bet": 1000, "reels": [[3,3,3,5,4,5,6],[3,3,3,4,5,6,7],[3,3,3,5,6,7,0],[1,2,5,6,7,0,1],[9,5,6,7,0,1,2],[5,6,7,0,1,2,3],[6,7,0,1,2,3,4]] }

Đủ 7×7. Production bỏ qua.

11. Error & tiền

12. Checklist client

• GET /gameplay trước mọi spin/buy — code 69 nếu thiếu.
• Board [col][row] 7×7. Play tumble + rush/surge/slash theo thứ tự server.
• Buy chỉ mở FS; mỗi lượt FS = POST /spins. Khóa bet/buy khi is_free_spin.
• JP credit ngay. Line win FS vào pot. Không song song 2 request / user.