---
# System prepended metadata

title: 遊戲API（OKAPI）專案功能定義

---

# 遊戲API（OKAPI）專案功能定義

# 目錄
[toc]


## OKAPI 平台帳戶定義
**Admin**

    - admin 《維護系統及管理員賬戶權限》
    - admin 助手《員工賬號》協助管理平台賬戶，分成，遊戲商結算
    
**Agent**
```
    - OKAPI客戶《現金網》每個使用現金網平台接入主賬號
    - OKAPI自動完成匹配對應遊戲商
```
**Player** 【待開發】
```
    - 所有現金網創建用戶都需要通過OKAPI創建並記錄《第一版是直接轉發API到遊戲平台創建用戶》
    - OKAPI自動完成匹配對應每個遊戲商playerID，減少市場/運營維護查詢成本90%以上
```
## 遊戲API/SDK描述


| 遊戲商 | 描述 |開發進度|SDK支持|
| -------- | -------- | -------- |-------- |
| Joker     | 綜合平台，電子遊戲  |
| GW88 | 綜合平台，電子遊戲 |
|XE | 綜合平台，電子遊戲  |
| PPSS888 |綜合平台，電子遊戲 APP模式 |
| 3WIN8 | 綜合平台，電子遊戲  |
| WWBET | 體育遊戲，無代理模式。 |



## 黑名單權限表《待開發》


**admin**


| 角色  |     對象      |       功能        |
|:-----:|:-------------:|:-----------------:|
| Admin |    Agent     |  關閉/暫停/活躍  |
|   Admin    | Player | 關閉/暫停/活躍 |
|   Agent    | Player | 關閉/暫停/活躍 |



----

## 核心功能


![](https://i.imgur.com/xsG9fr5.png)


### **平台遊戲商管理**

#### 1. 建立遊戲商賬號

- ###### 功能：Admin 對應每個接入遊戲商總代賬號與secretkey

```
- 在遊戲商創建總代號（人工客服，市場/運營責任）
- 在遊戲商申請總代號（人工客服，市場/運營責任）secretkey
- Admin後台管理遊戲商總代號和secretkey
```

#### 2.開關遊戲商支持

```
- OKAPI後台對每個遊戲商進行開關
```

#### 3.遊戲商賬目管理《待開發》
```
- OKAPI記錄並計算針對每個遊戲商的輸贏和總賬管理
- 已結算，編輯總賬功能？？？？？《待確定》
```


### **平台代理 Agent創建**

#### 1. 建立賬號

- ###### 功能：現金網通過商務在OKAPI上創建代理賬號（Agent）
```
- 創建專屬賬號
- OKAPI市場/運營聯繫各個遊戲商創建然後手動對應到平台代理賬號。手動維護secretkey
- OKAPI自動匹配賬號對應所有遊戲商（待開發）
  a.各個遊戲商創建單一總賬號
  b.平台代理hub（組件）將所有平台代理對應到同一個遊戲商賬號
  c.平台代理hub將遊戲商代理賬分配到OKAPI各個平台代理下
```

#### 2.開關遊戲商支持

```
- OKAPI後台對每個平台代理進行開關
```

#### 3.OKAPI 代理佔成
```
- OKAPI幫助每個代理（Agent）設定佔成數

```
### **平台玩家Player創建**

#### 1.OKAPI只能使用API創建遊戲玩家

```
- OKAPI每個平台代理secretkey以及遊戲玩家管理API（文檔）
- 每個創建遊戲玩家自動出現在OKAPI代理名單下級
- 新建遊戲玩家ID（OKAPI平台ID）會對應到每個遊戲商下的玩家ID。
 ```   
| OKAPI代理用戶  |   OKAPI ID    |       遊戲商    |ID|
|:-----:|:-------------:|:-----------------:|-------|
| example |    OK000001    |  JOKER  |JO000001|
|       |  |GW88 |GW000001|
|      |  |BETWIN |BW000001|

### 平台代理** Admin/Agent** 員工賬號創建

#### 1. Admin和Agent都可創建員工賬號管理業務《待開發》
    a. admin和agent員工賬號可從對應網址登入
    b. admin和agent可設定員工賬號權限和管理內容
    c. 員工賬號不可管理主賬號
    d. 員工賬號必須單一登入
    e. 登入/登出和操作 log記錄
    
### 公告《待完善》

#### 1. Admin負責管理公告

    a. admin新增公告：緊急公告，平台公告，遊戲公告
    b. admin管理公告開關和編輯功能
#### 2. 公告顯示為跑馬燈（Agent頁面）《待開發》
    a. 跑馬燈顯示為最新一則公告（無視分類）按照時間排序

### 平台公式定義
