Game List & Hall

Overview

• Description: Fetch the game list for a specific provider or category, providing WebP-compressed game icons for fast rendering.

Business Logic & Explanations

TIP

The game list retrieval system is highly optimized for security and frontend performance:

1. Parameter Encryption (Anti-Scraping): The provider_code or game_comp parameter passed by the frontend MUST be encrypted using Sha256. The backend will decrypt it before querying. Any direct plain-text tampering will be blocked.
2. Anti-Hotlinking & Image Compression: To hide the true third-party image URLs and improve loading speed, all game icons are fetched via a dedicated image gateway (/client/games/logo/...). The backend downloads the original image, converts it into a smaller .webp or .svg file, and caches it locally.
3. Dynamic Synchronization Tables: When fetching massive game lists from upstream aggregators, the system dynamically creates dedicated tables (e.g., game_gsc_xxx) to store hundreds of games, ensuring ultra-fast filtering and searching.
4. Status Interception: If the user's status is "Frozen (user_status=2/3)" or they are forced to "Change Password (setpassword=1)", the request will be instantly blocked.

---

1. GET - Get Game List

• Path: /client/games/list

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	Bearer Token

Request Parameters

Parameter	Type	Required	Description
provider_code	String	Yes	Provider ID/Code, must be Sha256 encrypted
game_type	String	Yes	Category, e.g., Slot, Live, Fish

Response Example

{
  "code": 0,
  "msg": "Success",
  "data": {
    "provider_name": "Pragmatic Play",
    "maintain_status": false,
    "list": [
      {
        "id": "vs20olympgate",
        "name": "Gates of Olympus",
        "icon": "https://api.domain.com/api/games/logo/pragmatic/vs20olympgate.webp",
        "type": "slot"
      }
    ]
  }
}