皇家電子遊戲 整合單一錢包 API Reference

1. 簡介

1-1 站台限制

本系統允許介接廠商(平台)自行建立多個站台。

1-2 玩家限制

本系統允許介接廠商(平台)自建的每個站台可建立多個會員。

1-3 登入限制

本系統同一會員同時只允許一個登入，達允許上限時，將會後踢前。

1-4 幣別限制

本系統允許同一會員擁有不同幣別的帳戶，各帳戶需個別建立。

1-5 名稱解釋

系統代碼：介接廠商(平台)申請使用本系統時所填寫之代號

站台代碼：介接廠商(平台)可為多個站台，自定各自的代碼

1-6 遊戲系統提供下列 API 程序

1-7 網站營運商提供下列 API 程序

2. 流程圖

2-1 建立會員(幣別帳戶)

2-2 進遊戲流程

3. API 使用說明

3-1 介接資訊

3-2 發送請求

1. 請求內文 需為“Msg=傳送的參數(JSON 格式)進行 DES-CBC 加密後的結果”

2. 標頭 需有以下 3 項

3. 對欲進行操作的 URL 做 POST 請求

4. 常見問題

1. 請求內文 (Request Body) 未加上Msg=

   ❌ 請求內文 (Request Body) 只有加密後的結果，但未加上Msg=

   xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

   ✅ 請求內文 (Request Body) 一定要加上Msg=

   Msg=xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

2. 請求內文 (Request Body) 使用雙引號

   ❌ 請求內文 (Request Body) 使用了雙引號

   Msg="xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE="

   ✅ 請求內文 (Request Body) 不需要加上雙引號

   Msg=xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

3. 回覆內文 (Response Body) 加上Msg=

   ❌ 回覆內文 (Response Body) 加上Msg=

   Msg=xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

   ✅ 回覆內文 (Response Body) 不需要加上Msg=

   xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

4. 請求參數的數字型別 (ex. int, decimal) 使用雙引號

   以 5-3 的 API 參數 GameId 為例

   ❌ 請求參數的數字型別 (ex. int, decimal) 使用雙引號

   { "GameId":"1" }

   ✅ 請求參數的數字型別 (ex. int, decimal) 不使用雙引號

   { "GameId":1 }

3-3 加密範例

原始資料

DES-CBC

{"SystemCode":"TestSystem"} => xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

md5 加密

3df82c9b0af3p@ssw0rd1494946640xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

MD5 => 9b58bd658add3e92ed214b6c3c0cbc87

請求資料

POST / request_url

3-4 程式碼 DES 範例

php 與 csharp 範例如右(點選php或csharp選單)

/// <summary>加密</summary>
$encrypt_data = openssl_encrypt($data,'DES-CBC',$DesKey,OPENSSL_RAW_DATA ,$DesIV);
$req_base64 = base64_encode($encrypt_data);
var_dump($req_base64);

/// <summary>解密</summary>
$data = openssl_decrypt(base64_decode($req_base64),'DES-CBC',$DesKey,OPENSSL_RAW_DATA ,$DesIV);
var_dump($data);

/// <summary>加密</summary>
public static string DESEncryption(string plainText, string key, string iv)
{
  using(var des = DES.Create())
  {
    des.Mode = CipherMode.CBC;
    des.Padding = PaddingMode.PKCS7;
    des.Key = Encoding.UTF8.GetBytes(key);
    des.IV = Encoding.UTF8.GetBytes(iv);
    byte[] plainByteArray = Encoding.UTF8.GetBytes(plainText);
    byte[] cipherByteArray = des.CreateEncryptor().TransformFinalBlock(plainByteArray, 0, 
    plainByteArray.Length);
    string cipherText = Convert.ToBase64String(cipherByteArray);
    return cipherText;
  }
}

/// <summary>解密</summary>
public static string DESDecrypt(string text, string key, string iv)
{
  using (var des = DES.Create())
  {
    des.Mode = CipherMode.CBC;
    des.Padding = PaddingMode.PKCS7;
    des.Key = Encoding.UTF8.GetBytes(key);
    des.IV = Encoding.UTF8.GetBytes(iv);
    byte[] plainByteArray = Convert.FromBase64String(text);
    byte[] cipherByteArray = des.CreateDecryptor().TransformFinalBlock(plainByteArray, 0, 
    plainByteArray.Length);
    string cipherText = Encoding.UTF8.GetString(cipherByteArray);
    return cipherText;
  }
}

3-5 程式碼 MD5 範例

php 與 csharp 範例如右(點選php或csharp選單)

$encrypt_data = openssl_encrypt($data,'DES-CBC',$key,OPENSSL_RAW_DATA ,$iv); 
$req_base64 = base64_encode($encrypt_data); 

$timestamp=time(); 

/// <summary>產生簽章</summary> 
$signature_data=$clientid.$clientsecret.$timestamp.$req_base64; 
$signature=md5($signature_data); 

/// <summary>產生簽章</summary>
public static string CreateSignature(string clientID, string clientSecret, string timestamp, string 
encryptData)
{
  using(var md5 = MD5.Create())
  {
    var inputText = clientID + clientSecret + timestamp + encryptData;
    var inputByteArray = Encoding.UTF8.GetBytes(inputText);
    var outputByteArray = md5.ComputeHash(inputByteArray);
    var outputText = ByteToHexBitFiddle(outputByteArray);
    return outputText;
  }
}
public static string ByteToHexBitFiddle(byte[] bytes)
{
  char[] c = new char[bytes.Length * 2];
  int b;
  for (int i = 0; i < bytes.Length; i++)
  {
    b = bytes[i] >> 4;
    c[i * 2] = (char)(55 + b + (((b - 10) >> 31) & -7));
    b = bytes[i] & 0xF;
    c[i * 2 + 1] = (char)(55 + b + (((b - 10) >> 31) & -7));
  }
  return new string(c);
}

3-6 調用 API 舉例

Send

Send

{
    "SystemCode":"TestSystem",
    "WebId":"Uy2m48TRCUo",
    "UserId":"497OHx21A0gInxza7zJj",
    "UserType":1,
    "Currency":"KRW"
}

Response

{
    "ErrorCode":0,
    "ErrorMessage":"OK",
    "Timestamp":1584512886,
    "Data":
    {
        "SystemCode":" TestSystem",
        "WebId":"Uy2m48TRCUo",
        "UserId":"497OHx21A0gInxza7zJj"
    }
}

POST /SingleWallet/Player/CreatePlayer HTTP/1.1
Host: 192.168.1.102:8866
Content-Type: application/x-www-form-urlencoded
X-API-ClientID: 3df82c9b0af3
X-API-Signature: 45d828b54aa091a5b137351e64673258
X-API-Timestamp: 1494946640

json 範例如右(點選json選單)

4. API 請求、標頭以及回傳資訊說明

4-1 請求 URL

4-2 標頭

各 API 請求時，皆需有如下的標頭，否則回傳錯誤代碼，錯誤代碼請參考 9-1

傳入的 Timestamp 超過現在時間 30 秒以上的呼叫，將被列為不合法的呼叫，會回傳 Invalid decrypt 的錯誤訊息。

4-3 傳入參數說明

各 API 請求時，傳入的 Key 為 request，Value 為以 UTF-8 編碼的 JSON 格式(相關資訊請參閱 「5. 遊戲系統 API 說明」)，且經 DES 加密後資料，故使用時需經過解密，且要通過 MD5 的 認證才可使用，否則會回傳 Invalid decrypt 的錯誤訊息。

4-4 回傳資訊說明

成功時

{
    "ErrorCode":0,
    "ErrorMessage":"OK",
    "Timestamp":1584512886,
    "Data":
    {
    "SystemCode":" TestSystem",
    "WebId":"Uy2m48TRCUo",
    "UserId":"497OHx21A0gInxza7zJj"
    }
}

失敗時
{
    "ErrorCode":2001,
    "ErrorMessage":"Illegal arguments.",
    "Timestamp":1584512886,
    "Data":null
}

各 API 不論執行成功或失敗，皆會以 UTF-8 編碼的 JSON 格式經 DES 加密後回傳，且內容包 含下列資訊Data 中的 JSON 格式資訊請參閱「5. 遊戲系統 API 說明」。

範例(此範例為明碼) /SingleWallet/Player/CreatePlayer 回傳資訊如下表

成功與失敗的 json 格式如右(點選json選單)

5. 遊戲系統 API 說明 🚀

以下三大類的錯誤代碼為所有 API 都可能會收到的

5-1 建立會員(幣別帳戶)

API 名稱：SingleWallet/Player/CreatePlayer

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：WebId 請依描述的規則自訂站台代碼 (不需在後台先新增)

5-2 取得遊戲列表

API 名稱：SingleWallet/Game/GameList

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

5-3 取得遊戲網址(進入遊戲)

API 名稱：SingleWallet/Player/GetURLToken

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：ExitAction 帶空字串 ( ExitAction=”” ) 時，離開遊戲時將關閉視窗

5-4 取得遊戲大廳網址(進入遊戲大廳)

API 名稱：SingleWallet/Player/GetLobbyURLToken

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

5-5 取得遊戲中的會員

API 名稱：SingleWallet/Player/PlayerOnlineList

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

5-6 剔除遊戲中的會員

API 名稱：SingleWallet/Player/Kickout

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

• 當 KickType=1，會剔除系統下所有人

，KickType=2，會剔除站台下所有人

，KickType=3，會剔除正在該遊戲的所有人

，KickType=4，會剔除特定會員

• 當 KickType=1，WebId、UserId 請填空字串，GameId 請填 0

，KickType=2，UserId 請填空字串，GameId 請填 0

，KickType=3，WebId、UserId 請填空字串

，KickType=4，GameId 請填 0

此 API 會回傳符合剔除條件的會員數量，符合條件者將於數秒內被剔除系統

5-7 查詢會員線上狀態

API 名稱：SingleWallet/Player/GetPlayerOnlineStatus

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

5-8 取得遊戲詳細資訊

API 名稱：SingleWallet/History/GetGameDetail

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

1. 可以查詢的範圍為目前時間的３分鐘前，最多可以查詢到目前時間往前 72 小時內。 譬如目前是 2020-04-24 16:30，只能查詢 2020-04-24 16:26 ～ 2020-04-21 16:31

2. WebId 有填值將只回傳該 WebId 底下的資料

3. WebId 為空字串時，將回傳該系統所有資料

4. 每次查詢最多 5 分鐘，譬如 TimeStart = 2020-04-24 16:22， TimeEnd = 2020-04-24 16:26，將取得 2020-04-24 16:22:00 ~ 2020-04-24 16:26:59 這 5 分鐘內的資料

5-9 取得遊戲每分鐘統計資訊

API 名稱：SingleWallet/Report/GetGameMinReport

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

1. 可以查詢的範圍為目前時間的３分鐘前，最多可以查詢到目前時間往前 72 小時內。 譬如目前是 2020-04-24 16:30，只能查詢 2020-04-24 16:26 ～ 2020-04-21 16:31

2. WebId 有填值將只回傳該 WebId 底下的資料

3. WebId 為空字串時，將回傳該系統所有資料

4. 每次查詢最多 15 分鐘，譬如 TimeStart = 2020-04-24 16:12， TimeEnd = 2020-04-24 16:26，將取得 2020-04-24 16:22:00 ~ 2020-04-24 16:26:59 這 15 分鐘內的，每分鐘的統計資料

5-10 取得遊戲每小時統計資訊

API 名稱：SingleWallet/Report/GetGameHourReport

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

1. 查詢小時為 2021-11-23 12，取得的數據範圍為 2021-11-23 12:00:00 至 2021-11-23 12:59:59

2. 可以查詢的範圍為目前時間的 2 小時前，最多可以查詢到 1440 小時內(60 天內)。 譬如目前是 2021-11-23 14:02，可查詢範圍為 2021-09-24 14～ 2021-11-23 12

3. WebId 有填值將只回傳該 WebId 底下的資料

4. WebId 為空字串時，將回傳該系統所有資料

5-11 取得遊戲每小時統計資訊(全部遊戲類型)

API 名稱：SingleWallet/Report/GetGameHourReportAllGameType

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

1. 查詢小時為 2021-11-23 12，取得的數據範圍為 2021-11-23 12:00:00 至 2021-11-23 12:59:59

2. 可以查詢的範圍為目前時間的 2 小時前，最多可以查詢到 1440 小時內(60 天內)。 譬如目前是 2021-11-23 14:02，可查詢範圍為 2021-09-24 14～ 2021-11-23 12

3. WebId 有填值將只回傳該 WebId 底下的資料

4. WebId 為空字串時，將回傳該系統所有資料

5-12 取得遊戲每日統計資訊

API 名稱：SingleWallet/Report/GetGameDailyReport

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

1. 查詢日期為 2020-04-24，取得的數據範圍為 2020-04-24 12:00:00 至 2020-04-25 11:59:59

2. 可以查詢的開始範圍為一天前，最多可以查詢到 60 天內，譬如目前是 2020-04-24 10:30，可查詢的開始範圍為 2020-04-22。

3. WebId 有填值將只回傳該 WebId 底下的資料

4. WebId 為空字串時，將回傳該系統所有資料

5-13 取得遊戲每日統計資訊(全部遊戲類型)

API 名稱：SingleWallet/Report/GetGameDailyReportAllGameType

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

5-14 取得某帳戶某分鐘內的遊戲歷程網址

API 名稱：SingleWallet/Player/GetGameMinDetailURLToken

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

5-15 取得某帳戶某分鐘內的遊戲歷程網址 ( By SequenNumber )

API 名稱：SingleWallet/Player/GetGameMinDetailURLTokenBySeq

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

SequenNumber 的來源為 5-9 取得遊戲每分鐘統計資訊 API 回傳的Data/GameReport/SequenNumber 該分鐘起始的遊戲紀錄編號

5-16 取得某帳戶 slot 遊戲歷程的遊戲盤面

API 名稱：SingleWallet/Player/GetSlotGameRecordURLToken

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

5-17 取得 Jackpot 中獎紀錄

API 名稱：SingleWallet/Jackpot/GetJackpotHitRec

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

1. 查詢日期為 2021-11-22 ~ 2021-11-24，取得的數據範圍為 2021-11-22 12:00:00 至 2021-11-25 11:59:59

2. 可以查詢最多 60 天內，譬如目前是 2021-11-24 19:12:28，可查詢範圍為 2021-09-25 ～ 2021-11-24

3. WebId 有填值將只回傳該 WebId 底下的資料

4. WebId 為空字串時，將回傳該系統所有資料

5. JackpotType 的類型

5-18 取得特定序號的贏分值

API 名稱：SingleWallet/History/GetSeqResult

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

補充說明：

可以查詢的範圍為目前時間的３分鐘前，最多可以查詢到目前時間往前 72 小時內。

譬如目前是 2021-04-24 16:30，只能查詢 2020-04-24 16:26 ～ 2020-04-21 16:31

6. 網站營運商需提供下列 API 給 RSG 遊戲平台

營運商提供的 API 請遵循以下規範來設計：

1. 資料傳輸與加解密方式請與 遊戲系統 API 相同，請參考 3.API 使用說明 以及 4. API 請求、標頭以及回傳資訊說明

2. API 執行後的回傳結果請用以下規範的錯誤代碼

   (1) 以下錯誤代碼為所有 API 共同的

   錯誤代碼	錯誤訊息	描述
   0	OK	正常
   1001	Execute failed.	執行失敗
   1002	System is in maintenance.	系統維護中
   2001	Illegal arguments.	無效的參數
   2002	Invalid decrypt.	解密失敗

   (2) 各 API 的特定回傳錯誤代碼 ( 請詳見各 API )

   錯誤代碼	錯誤訊息	描述
   4001	The player's currency doesn't exist.	此玩家帳戶不存在
   4002	Duplicate SequenNumber.	重複的 SequenNumber
   4003	Balance is not enough.	餘額不足
   4004	The SequenNumber doesn't exist.	此 SequenNumber 不存在
   4005	This SequenNumber has been settled.	此 SequenNumber 已被結算
   4006	This SequenNumber has been cancelled.	此 SequenNumber 已被取消
   4007	Duplicate TransactionId.	重複的TransactionId
   4008	Deny prepay, other reasons.	拒絕預扣，其他原因
   4009	Transaction is not found.	找不到交易結果

3. {{url}}：網站營運商提供給 RSG 遊戲平台呼叫的 API 網址

4. 本遊戲系統根據遊戲時的 SPIN 狀況，會有不同的子遊戲代碼(請參照代碼表)。
   在呼叫營運商提供的 API 時，其中除了 Jackpot 的子遊戲名稱是
   單獨使用 JackpotResult (6-4)，其它子遊戲會成對使用 Bet (6-2) 與 BetResult (6-3)

5. Bet (6-2) API 的 Amount 參數只在子遊戲代碼(請參照代碼表)對應的
   名稱為”一般”時會有大於 0 的下注 (舉例：子遊戲代碼為 0 或 3000)，其它子遊戲代碼下注皆會帶 0

6. SequenNumber 為遊戲紀錄惟一編號(以下簡稱 Seq) (1) Seq 會成對出現在 下注與結算 API
   (2) Seq 在 Jackpot 中獎時則只會單獨出現

7. 常見問題

   1. 營運商回覆 RSG 回覆內文 (Response Body) 不需要加上 Msg=

      ❌ 回覆內文 (Response Body) 加上Msg=

      Msg=xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

      ✅ 回覆內文 (Response Body) 不需要加上Msg=

      xkf7wEkQvp+LJTravXHY9RDEX24YMjQxnV/5DPCoIKE=

6-1 取得餘額

API 名稱：{{url}}/GetBalance

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

6-2 下注

API 名稱：{{url}}/Bet

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

6-3 結算

API 名稱：{{url}}/BetResult

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

6-4 Jackpot 中獎

API 名稱：{{url}}/JackpotResult

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

6-5 取消下注

API 名稱：{{url}}/CancelBet

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

捕魚機遊戲 預付款API 說明

6-6 預扣及 6-7 退款和 6-8 檢查交易，將針對所支援魚機遊戲進行相關的 api 動作。

目前支援預扣款魚機遊戲列表：

RSG 將會向平台廠商預扣一筆金額。其規則為各魚機遊戲廳別所定義。但當玩家額度不足於預扣該廳別的金額則會預扣玩家全部額度。

• 範例一: 所需金額為 27,000 而玩家額度只有 13,000 則預扣 13,000，玩家在廠商額度為 0

• 範例二: 所需金額為 27,000 而玩家額度只有 50,000 則預扣 27,000，玩家在廠商額度剩 23,000

玩家會因個別的魚機遊戲，分別向廠商進行預扣。但最終在 RSG 內部金額則為兩款遊戲預扣的總額。

• 範例1 : 登入海霸王-歡樂廳預扣 18, 000，登出立即遊玩福娃補魚-歡樂廳需要 2,700，但在 RSG 內部餘額已有 18,000 則滿足 2,700 預扣需求，因此不再向廠商進行預扣

• 範例2: 登入福娃補魚-歡樂廳預扣 2,700，登出立即遊玩海霸王-歡樂廳，其所需金額 18, 000，因此會再向廠商預扣 15,300 (18,000 - 2,700) ，若玩家不足 15,300 則會將玩家當前的餘額進行預扣

玩家一旦有預扣一筆金額至 RSG 內部，並開始射擊將使用 RSG 內部錢包開始扣款。而扣款至餘額為 0 時，需重新載入遊戲才會重新再向廠商預扣所需額度。

另外玩家一旦進行預扣後，切換廳別並不會再向廠商預扣。直到登出並進行退款後才能重新預扣金額。

玩家登入時，若第一次向廠商進行預扣失敗，會使用 6-8 檢查交易 api 向廠商查詢該筆預扣交易，若是該筆預扣交易存在則會讓玩家繼續登入遊戲，不存在則會中斷玩家連線。

預付金額說明

海霸王 ( 3001 ) 預扣金額：當下進入廳別的最大押注 x 1800 以下為預扣範例：

福娃捕魚 ( 3002 ) 預扣金額：當下進入廳別的最大押注 x 2700 以下為預扣範例：

預扣成功時序圖

預扣失敗時序圖

退款成功時序圖

退款失敗時序圖

RSG 會因為玩家進出不同的魚機遊戲有可能會多次向廠商進行預扣，但僅有登出後一分鐘的退款動作。在多次的預扣及退款中，會在 Prepay 及 Refund api 請求中帶入 SessionId 參數作為同一個交易過程唯一識別碼

交易時序圖

6-6 預扣

API 名稱：{{url}}/Prepay

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

6-7 退款

API 名稱：{{url}}/Refund

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

6-8 檢查交易

API 名稱：{{url}}/CheckTransaction

• 傳入參數說明

• 回傳資訊說明

• 特定回傳錯訊代碼一覽

7. FTP 功能

7-1 功能說明

FTP 方式依提供以下三種資料

1. 遊戲詳細交易信息

2. 遊戲每分鐘統計資訊

3. 遊戲每日統計資訊

7-2 目錄說明

FTP 內的目錄第一層會先以資料分類與遊戲分類做區分，

第二層會以日期來區分，譬如：20200325，20200326，

每日統計資訊無第二層目錄。

目錄範例：

1. 遊戲詳細交易信息：history_fish / 20200325

2. 遊戲每分鐘統計資訊：report_min_slot / 20200326

3. 遊戲每日統計資訊：report_daily

7-3 壓縮檔名說明

遊戲詳細交易信息 和 遊戲每分鐘統計資訊 的壓縮檔名

由資料分類、遊戲分類、系統代碼、起始時間、結束時間所組成

檔名範例：

report_min_slot_TestSystem_202003251710_202003251719.zip

該壓縮檔內的資料時間範圍：2020-03-25 17:10:00 ~ 17:19:59

裡面會有最多 10 分鐘內的檔案

每日統計資訊 的壓縮檔名

由資料分類、系統代碼、日期所組成

檔名範例：

report_daily_TestSystem_20200325.zip

7-4 檔名說明

遊戲詳細交易信息 和 遊戲每分鐘統計資訊 的檔名

檔案會依照資料分類、遊戲分類、系統代碼、站台代碼、每分鐘

組成一個 CSV 檔

檔名範例：

report_min_slot_TestSystem_web4_20200325_1712.csv

該 CSV 檔內的資料時間範圍：2020-03-25 17:12:00 ~ 17:12:59

每日統計資訊的檔名

檔案會依照資料分類、遊戲分類、系統代碼、站台代碼、日期

檔名範例：

report_min_slot_TestSystem_web4_20200325.csv

7-5 欄位說明

1. 遊戲詳細交易信息：請參照 5-8 取得遊戲詳細資訊

2. 遊戲每分鐘統計資訊：請參照 5-9 取得遊戲每分鐘統計資訊

3. 遊戲每日統計資訊：請參照 5-12 取得遊戲每日統計資訊

8. API 取明細與取盤面網址

8-1 老虎機

1. 5-8 取得遊戲詳細資訊 ( SingleWallet/History/GetGameDetail )

2. 5-16 取得某帳戶 slot 遊戲歷程的遊戲盤面 ( SingleWallet/Player/GetSlotGameRecordURLToken )

8-2 捕魚機

捕魚機由於數據量較多，建議用以下來搭配使用

1. 5-9 取得遊戲每分鐘統計資訊 (SingleWallet/Report/GetGameMinReport )

2. 取得某帳戶某分鐘內的遊戲歷程網址

   a. 參數為"分鐘" 5-14 (SingleWallet/Player/GetGameMinDetailURLToken)

   b. 參數為"Seq" 5-15 (SingleWallet/Player/GetGameMinDetailURLTokenBySeq)

以上(1)為捕魚遊戲每分鐘匯總，(2)則為每分鐘細單連結(a 或 b 擇一來使用) Seq 為該分鐘第一個 SequenNumber

9. 錯誤代碼

9-1 錯誤代碼表

9-2 會得到錯誤代碼 2002 的 3 種情況：

1. 加密錯誤

2. POST 資料時，未在 body 以 Msg=xxxxx 的方式傳送

3. X-API-Timestamp 時間有誤，傳入的 Timestamp 超過現在時間 30 秒以上的呼叫

9-3 會得到錯誤代碼 2001 的常見情況：

1. 數值型態 ( Int，Long，Decimal ) 的參數，在傳送時請移除雙引號

   錯誤 => {"GameId": "36"}，正確 => {"GameId": 36}

2. 時間參數，請注意 API 參數的 長度 以及 描述，總計有以下 3 種

   yyyy-MM-dd HH:mm

   yyyy-MM-dd HH

   yyyy-MM-dd

附錄 A - 遊戲代碼表

版本: v1.16.0

1. 遊戲代碼

1-1 說明

本遊戲代碼供遊戲介接以及歷史紀錄獲取後的識別用

目前提供 85 款老虎機、 2 款捕魚機、 1款街機，遊戲畫面「開心農場」和「雷神之錘」

有支援直式與橫式，「麻將發了」和 「麻將發了2」「聚寶財神」、「魔龍傳奇」、「黃金摔角

手」、「有請財神」、「迦羅寶石4」、「超級王牌2」、「勇闖黃金城」、「狗來富」、「逛夜市3」以及「大過年3」只支援直式，其它都只支援橫式

1-2 老虎機遊戲代碼(遊戲畫面只限橫式)

1-3 老虎機遊戲代碼(遊戲畫面只限直式)

1-4 老虎機遊戲代碼(直橫式皆有)

1-5 捕魚機遊戲代碼(遊戲畫面只限橫式)

1-6 街機遊戲代碼(遊戲畫面只限橫式)

2. 子遊戲代碼

2-1 說明

本子遊戲代碼供歷史紀錄獲取後的識別用

2-2 老虎機子遊戲代碼

2-3 捕魚機子遊戲代碼

附錄 B - 幣別代碼表

版本: v1.4.0

附錄 C - 語系代碼表

版本: v1.1.0

附錄 D - 版本說明

1.9.0

1. 新增四種幣別
   • 日圓 130
   • 越南盾原幣
   • 泰銖 5000
   • 寮國基普原幣

1.8.0

1. 雷神之錘支援直橫式

1.7.0

1. 新增兩款新遊戲
   • 老虎機遊戲
     • 逛夜市3
     • 大過年3

1.6.1

1. 修正 6-7退款的回傳資訊的描述

1.6.0

1. 新增五款新遊戲
   • 老虎機遊戲
     • 侏羅紀寶藏
     • 勇闖黃金城
     • 麻將發了2
     • 狗來富
   • 街機遊戲
     • 皇冠5PK

1.5.0

1. 新增兩款新遊戲
   • 迦羅寶石4
   • 超級王牌2

1.4.0

1. 新增 3-2 發送請求 常見問題清單
2. 新增 6. 網站營運商需提供下列 API 給 RSG 遊戲平台 常見問題清單
3. 新增回首頁連結

1.3.0

1. 將 API 文件由 PDF 版本轉為網頁版本，本版本為網頁版初始版

1.2.0

1. 修正 3-5 程式碼 PHP 的 MD5 範例

2. API 增加參數

   • 5-4 取得遊戲大廳網址(進入遊戲大廳) - SingleWallet/Player/GetLobbyURLToken 新增離開時的 url 參數: ExitAction，此參數不用強制傳入

3. 新增 ErrorCode = 3018，此幣別不被允許，會回傳此錯誤的 API 如下：

   • 5-1 建立會員(幣別帳戶) - SingleWallet/Player/CreatePlayer
   • 5-3 取得遊戲網址(進入遊戲) - SingleWallet/Player/GetURLToken
   • 5-4 取得遊戲大廳網址(進入遊戲大廳) - SingleWallet/Player/GetLobbyURLToken