# RG PointCenterAPI V1 轉 V2 摘要
API V1 將於 2023-07-01 停止支援，本文列出 V1 轉 V2 需修改的位置。
V2介接網址需調整為以下:

**http://rcgapiv2.dev-royalgame.com/**

## 拉帳注意事項
1. API 切換時，為避免重覆拉帳應先確保 v1 的拉帳程式已停止，才能開啟 v2 的拉帳程式。
2. 同時在切換之前必須保留 v1 拉帳的 maxId 來作為 v2 拉帳的初始 maxId

>說明
PointCenter API v1 第 5.6 取回會員流水帳務列表-拉帳
最後注單編號為 10999。
則切換後
PointCenter API v2 需使用 10999 作為初始 MaxId 來拉帳.內容請詳閱 PointCenter v2 文件

## 加解密方式
因修改幅度較大，建議使用 V2 文件重新串接。

## API 全域性修改
1. 回傳參數屬性名(Property Name)皆改為小寫開頭。
2. 呼叫參數中及回傳參數中若有 UserId 者，皆改為 MemberAccount (若為回傳參數則開頭為小寫)。

### API 修改細項
#### 5.1 取得限注範本
回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|Max|bpMax|
|Min|bpMin|

#### 5.2 建立與更新會員
呼叫參數變更項目：
|原屬性名|新屬性名|
|---|---|
|AgentID|移除|
|GroupLimitId|BetLimitGroup|
|UserId|MemberAccount|
|UserName|MemberName|

回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|memberAccount|

#### 5.3 取得 Url Token
在 V2 版中已移除該 API ，與 /api/Player/Login 整合。

#### 5.4 進入遊戲大廳或遊戲
在 V2 版中的 /api/Player/Login 整合 V1 的 5.3 與 5.4。請詳閱 V2 文件重新串接。

#### 5.5 查詢玩家在線列表
回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|memberAccount|
|GameDeskID|v2 移除|
|無|ServerNo|

`GameDeskId 與 ServerNo 資料內容不同，不可直接代替`

#### 5.6 取回會員流水帳列表-拉帳 5.7 取回會員改單帳務列表
在 v2 版中的改牌單邏輯與 v1 有差異，請詳閱 V2 文件重新串接。一併將拉帳與改單帳務重新串接。

#### 5.8 查詢開牌紀錄
呼叫參數變更項目：
|原屬性名|新屬性名|
|---|---|
|ShoeNo|ActiveNo|

回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|ShoeNo|activeNo|

#### 5.9 存錢

呼叫參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|MemberAccount|
|TransactionID|TransactionId|
|Balance|TransactionAmount|

回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|memberAccount|
|TransactionID|transactionId|
|DepositBalance|transactionAmount|
|CurrentPlayerBalance|balance|

#### 5.10
呼叫參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|MemberAccount|
|TransactionID|TransactionId|
|Balance|TransactionAmount|

回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|memberAccount|
|TransactionID|transactionId|
|WithdrawBalance|transactionAmount|
|CurrentPlayerBalance|balance|

#### 5.11 取得玩家餘額
呼叫參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|MemberAccount|

回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|memberAccount|
|UserType|memberType|
|CurrentPlayerBalance|balance|

#### 5.12 取得遊戲桌別資訊
該 API v1 與 v2 修改甚多，且遊戲桌別仍基礎資料。建議詳閱 v2 文件重新串接。

#### 5.13 取得交易紀錄
呼叫參數變更項目：
|原屬性名|新屬性名|
|---|---|
|TransactionID|TransactionId|

回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|memberAccount|
|TransactionID|transactionId|
|Balance|transactionAmount|

#### 5.14 玩家踢線
呼叫參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|MemberAccount|

回傳參數變更項目：
|原屬性名|新屬性名|
|---|---|
|UserId|memberAccount|