> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cog888.net/llms.txt
> Use this file to discover all available pages before exploring further.

# API 說明

> 單一錢包 API 文檔介紹

## 1. 基本資訊

1. 本文件是由 `Wallet-API` 和 `Game-API` 組成。
   * **Wallet-API** 是為變更玩家餘額而向 vendor 請求的 API，由 vendor 實作。
   * **Game-API** 是 vendor 向遊戲取得遊戲相關數據的 API。
2. POST 及 PUT 請求支援 application/json 及 application/x-www-form-urlencoded；GET 請求參數透過 query string 傳遞。
3. 任意 API connect timeout 都為 2 秒，且 read timeout 皆為 15 秒。
4. 本遊戲玩家的線上的額度操作，皆會與現場真人電投手籌碼下注整合，電投手資訊將以現場帳房提案的形式記錄，並且在同步注單時會提供該注單所屬的現場提案序號。
5. 本遊戲提供 1 對 1 傳統電投手籌碼下注模式（以下簡稱傳統模式）以及 1 對多快速電投手籌碼下注模式（以下簡稱快速模式）。
6. 接入方須提供分別對應傳統模式與快速模式兩種模式的玩家錢包，才可以獲得完整的遊戲體驗，以下文件將分別用傳統錢包跟一般錢包代稱。
7. 接入方需留意以下設置，以確保完整遊戲體驗：
   * 允許觸控
   * 允許 localStorage
   * 允許 webview 相關設定（如 GestureDetector 等手勢相關操作）
   * 避免複寫任何 inline style

***

## 2. 金額說明

與 `金額` 相關的參數，若為整數型態不需帶小數點，如 `100`；基於現場下注籌碼皆為整數下注，故金額相關數值只會以整數為主。

***

## 3. 認證方式

所有 API 請求都需要包含 `key` 參數進行驗證，計算方式為：

```
key = md5(參數組合 + 平台密鑰)
```

各 API 的參數組合請參考個別 API 說明。