API

1. 聯絡我們取得代理商的安全密鑰 ( Secret_key )
2. 所有接口使用 POST 協議進行請求
3. 傳輸內容， 一律使用 utf8 編碼
4. 傳入與傳出皆為 Json 格式
5. 發送命令需用 AES-256-CBC 加密處理
6. 貨幣單位皆為 0.0001 ( 萬分之一 )，請參考 貨幣處理

發送命令時需將命令打包成如下的 Json 格式

範例

	
		{
			"Agent_name": "DD00001"，// 代理商別名
			"Code": "qu90XJg6U8Te9kKikdPGnQFlL9YT90vssu9I5KpyXNWCLZN3/c4SQwJVUWMLrfJZQlpNiGaKpaQI7oLhXhIAW/eGMvbo7hsrikga/foE9cuFJGf6KeA9jAiDgJb1q9KSxtPXsSAgwIE0fdek8s8kJVamzw8MDIjJYMfAz8dTgOoAV9NerF3sP4vqPLQcfBw1" // 使用 base64 處理過的 iv + AES-256-CBC 密文， Secret_key = 代理商的安全密鑰
		}
	

API 列表

請諮詢我們取得API網址

單一錢包 API 列表

單一錢包 API URL 皆由代理商(平台)提供

貨幣處理

調用 API 的參數中代表金額的欄位，單位皆為 0.0001 ( 萬分之一 )，例如轉入 1 元時 Amount 參數為 10000 。

加密要求

所有的 API 服務在傳輸前都要求用 AES-256-CBC 加密和 MD5 Hash 進行數位簽名，以保證內容在傳輸過程中不會被修改。
請諮詢我們以下資訊：

• 安全密鑰 Secret_key
• 代理商別名 Agent_name
• API url

ASP.NET C# AES-256-CBC 加密函數範例

        
public static string EncryptAES256CBCByText(string data， string secretKey)
{
    byte[] key = Encoding.UTF8.GetBytes(secretKey);
    byte[] iv = new byte[16];
    using (var rng = new RNGCryptoServiceProvider())
    {
        rng.GetBytes(iv);
    }

    using (Aes aes = Aes.Create())
    {
        aes.Key = key;
        aes.IV = iv;
        aes.Mode = CipherMode.CBC;
        aes.Padding = PaddingMode.PKCS7;
        ICryptoTransform encryptor = aes.CreateEncryptor(aes.Key， aes.IV);
        using (var msEncrypt = new System.IO.MemoryStream())
        {
            using (var csEncrypt = new CryptoStream(msEncrypt， encryptor， CryptoStreamMode.Write))
            {
                using (var swEncrypt = new StreamWriter(csEncrypt))
                {
                    swEncrypt.Write(data);
                }
                byte[] encrypted = msEncrypt.ToArray();
                string code = Convert.ToBase64String(iv.Concat(encrypted).ToArray());
                return code;
            }
        }
    }
}
                                            
                                        

PHP AES-256-CBC 加密函數範例

        
public static function encryptAES256CBCByText($data， $secretKey)
{
    $key = $secretKey;
    $iv = openssl_random_pseudo_bytes(16);

    $ciphertext = openssl_encrypt($data， 'aes-256-cbc'， $key， OPENSSL_RAW_DATA， $iv);
    $encrypted = base64_encode($iv . $ciphertext);

    return $encrypted;
}
                                                
                                            

Node.js AES-256-CBC 加密函數範例

        

function encryptAES256CBCByText(data， secretKey) {
    const key = Buffer.from(secretKey， 'utf8');
    const iv = crypto.randomBytes(16);
    const cipher = crypto.createCipheriv('aes-256-cbc'， key， iv);
    let encrypted = cipher.update(data， 'utf8'， 'base64');
    encrypted += cipher.final('base64');
    return Buffer.concat([iv， Buffer.from(encrypted， 'base64')]).toString('base64');
}
                                                
                                            

ASP.NET C# MD5 hash 函數範例

        
public static string GetMd5Hash(this string input)
{
    using (MD5 md5 = MD5.Create())
    {
        byte[] hashBytes = md5.ComputeHash(Encoding.UTF8.GetBytes(input));
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < hashBytes.Length; i++)
        {
            sb.Append(hashBytes[i].ToString("x2"));
        }
        return sb.ToString();
    }
}
                                                
                                            

PHP MD5 hash 函數範例

        
function getMd5Hash($input)
{
    return md5($input);
}
                                                
                                            

Node.js MD5 hash 函數範例

        
function getMd5Hash(input) {
    return crypto.createHash('md5').update(input).digest('hex');
}
                                                
                                            

加密流程

呼叫API舉例

以玩家帳號登入舉例

假設資料如下

• Agent_name : PM0122222
• Account : acc0001
• Timestamp : 1722913476

簽名為 Signature = Secret_key+Agent_name+Account+Timestamp 再轉 MD5 雜湊字串

假設 Secret_key 是 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Signature 為 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxPM0122222acc00011722912445 再轉 MD5 雜湊字串

組成傳入參數的 JSON 如下

        
{
    "Agent_name": "PM0122222"，                      // 代理商別名
    "Account": "acc0001"，                           // 玩家帳號(3~50碼全小寫英文字+數字)
    "Timestamp": 1722913476，                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "fcf9dc4001a3c35605cff438ea6f8562" // 簽名
}
                                            
                                        

input 字串再用 Secret_key 以 AES-256-CBC 加密後得到 code 的值，組合成最終的 http request body

        
{
    "Agent_name": "PM0122222"， // 代理商別名
    "Code": "6/fvX2EdsA5pxLppI5q\u002BCEDZWWSrlplxHq9Idt\u002BuwXRADBOMUGCc28p9jiJUnRTP7y10pm0BohB5D2sY8pj2F8f7/M/Oj1100D9XlnKH1zO4oVQPDGFf3x0pJfO9h65xvjPUEFf1TU9Ac0gzB4jm6fsH98aYbTxaWH4BVOvxji09/wYnYd\u002BOm/hRHZkiVFJZ" // 使用 base64 處理過的 iv + AES-256-CBC 密文， Secret_key = 代理商的安全密鑰
}

                                        
                                    

POST 到 https://game.pokermars.com/api/v1/agent/player_login ( 請求內文必須使用 "Content-Type: application/json" 格式 )

得到返回結果

        
{
    "Error_code": 1，                // 錯誤碼
    "Msg": "成功"， // 訊息
    "Token": "7057049464837"         // 玩家登入遊戲專用的Token
}
                                        
                                    

錯誤處理

當解密、簽名不正確時，返回結果會輸出以下錯誤回應。

Error_code -10 解密失敗

Error_code -105 Json 解碼失敗

Error_code -125 簽名驗證失敗

解密要求

安全起見, 單一錢包 API 的內文經過加密，因此收到需求後須進行解密才得到真實內容。
解密與加密邏輯一致，使用一樣的安全密鑰與代理商別名。API url 則由代理商提供。

• 安全密鑰 Secret_key
• 代理商別名 Agent_name
• API url 由代理商提供

ASP.NET C# AES-256-CBC 解密函數範例

		
public static string DecryptAES256CBC(string encryptContent, string secretKey)
{
	byte[] fullCipher = Convert.FromBase64String(encryptContent);

	byte[] key = Encoding.UTF8.GetBytes(secretKey);

	byte[] iv = fullCipher.Take(16).ToArray();

	byte[] cipherText = fullCipher.Skip(16).ToArray();

	using (Aes aes = Aes.Create())
	{
		aes.Key = key;
		aes.IV = iv;
		aes.Mode = CipherMode.CBC;
		aes.Padding = PaddingMode.PKCS7;

		ICryptoTransform decryptor = aes.CreateDecryptor(aes.Key, aes.IV);

		using (var msDecrypt = new System.IO.MemoryStream(cipherText))
		{
			using (var csDecrypt = new CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read))
			{
				using (var srDecrypt = new StreamReader(csDecrypt))
				{
					return srDecrypt.ReadToEnd();
				}
			}
		}
	}
}
											
										

PHP AES-256-CBC 解密函數範例

		
public static function decryptAES256CBCByText($encryptedData, $secretKey)
{
	$key = $secretKey;
	$decoded = base64_decode($encryptedData);

	$iv = substr($decoded, 0, 16);
	$ciphertext = substr($decoded, 16);

	$decrypted = openssl_decrypt($ciphertext, 'aes-256-cbc', $key, OPENSSL_RAW_DATA, $iv);

	return $decrypted;
}
												
											

Node.js AES-256-CBC 解密函數範例

		

const crypto = require('crypto');

function decryptAES256CBCByText(encryptedData, secretKey) {
	const key = Buffer.from(secretKey, 'utf8');
	const decodedData = Buffer.from(encryptedData, 'base64');

	const iv = decodedData.subarray(0, 16);
	const encryptedText = decodedData.subarray(16);

	const decipher = crypto.createDecipheriv('aes-256-cbc', key, iv);
	let decrypted = decipher.update(encryptedText, 'base64', 'utf8');
	decrypted += decipher.final('utf8');

	return decrypted;
}
												
											

解密流程

API 請求流程範例

取得玩家餘額範例

假設收到的 API request body 如下

			
{
	"Agent_name": "PM0120001"，											// 代理商別名
	"Code": "RVZ5abDsWReqa1FDypByadrHPFzSXmEevM0fdWWiYtCxL5ZdWwKcygfo\u002BWPzSfe0Xm2xylaWn7CgeXTeU3EspL
	bQM/pXENHWrxZxXD9Tcveaszmhhk88ZwkIb3egBm7/3Obh3eHdpDiZSfbeTq91VQ==" // 使用 base64 處理過的 iv + AES-256-CBC 密文， Secret_key = 代理商的安全密鑰
}

			
		

對參數 code 字串進行解密, 得到內文參數物件

			
{
	"Account": "singleaccount001",
	"Timestamp": 1741758634,
	"Signature": "a11f0141bf5f28869b02d60d540947b2"
}

			
		

檢查其簽名 ( Signature ) 欄位，是否符合約定的簽名邏輯

簽名驗證成功則返回玩家餘額 API response

		
{
	"Data": {
		"account": "singleaccount001",
		"balance": 10000000,
		"currency": 1
	},
	"Error_code": 1,
	"Msg": ""
}

			
		

錯誤處理

當解密、簽名不正確時，返回結果會輸出以下錯誤回應。

Error_code -10 解密失敗

Error_code -105 Json 解碼失敗

Error_code -125 簽名驗證失敗

建立玩家帳號

• API 名稱 /v2/agent/player_create
• 請求協議 POST

傳入參數

返回結果

傳入參數 範例

    
{
    "Agent_name": "PM0100001",                       // 代理商別名
    "Account": "account001"，                        // 玩家帳號(3~50碼全小寫英文字+數字)
    "Nickname": "account001"，                       // 暱稱
    "Timestamp": 1722918019，                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "7a6d69a4bcb732506b36fc0231fa15a1"  // 簽名
}                                     
                                        
                                    

返回結果 範例

    
{
    "Error_code": 1，                // 錯誤碼
    "Msg": "Success"，               // 訊息
    "Token": "7057049464837"         // 玩家登入遊戲專用的Token
}
                                        
                                    

玩家帳號登入

• API 名稱 /v2/agent/player_login
• 請求協議 POST

傳入參數

返回結果

傳入參數 範例

    
{
    "Agent_name": "PM0100001", // 代理商別名
    "Account": "account001"，  // 玩家帳號(3~50碼全小寫英文字+數字)
    "Timestamp": 1722918019，  // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "7a6d69a4bcb732506b36fc0231fa15a1" // 簽名
}                                     
                                        
                                    

返回結果 範例

    
{
    "Error_code": 1，                // 錯誤碼
    "Msg": "Success"，               // 訊息
    "Token": "7057049464837"         // 玩家登入遊戲專用的Token
}
                                        
                                    

取得遊戲進入網址

• API 名稱 /v2/agent/get_game_url
• 請求協議 POST

傳入參數

返回結果

傳入參數 範例

    
{
    "Agent_name": "PM0122222"，  // 代理商別名
    "Account": "acc0001"，       // 玩家帳號(3~50碼全小寫英文字+數字)
    "Lang":"en",                 // 語言設定
    "Return_url": "aHR0cDovLzE5Mi4xNjguMS4yMDI6ODA4MA"， // 遊戲退出轉跳網址(例:https://www.abc.com)(使用base64url編碼)
    "Timestamp": 1722929138，                            // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "9aa963d0a21907eaa25f5daddb1dcfe7"      // 簽名
}
                                        
                                    

返回結果 範例

    
{
    "Error_code": 1，                	// 錯誤碼
    "Msg": "Success"， 					// 訊息
    "Game_url": "60.251.230.110/PokerDream/?token=7061713551368&return_url=aHR0cDovLzE5Mi4xNjguMS4yMDI6ODA4MA" // 遊戲進入網址
}
                                        
                                    

取得玩家資訊

• API 名稱 /v2/agent/get_player_info
• 請求協議 POST

傳入參數

返回結果

傳入參數 範例

    
{
    "Agent_name": "PM0100001", // 代理商別名
    "Account": "account001"，  // 玩家帳號(3~50碼全小寫英文字+數字)
    "Timestamp": 1722918019，  // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "7a6d69a4bcb732506b36fc0231fa15a1" // 簽名
}
                                        
                                    

返回結果 範例

    
{
    "Error_code": 1，                // 錯誤碼
    "Msg": "成功"， // 訊息
    "Player_info": {                 // 玩家資訊結構， 下面僅列出對代理商有用的資訊
        "GOLD_p": [
            20000000，               // GOLD_p[0]=測試幣
            60000，                  // GOLD_p[1]=正式幣
            0，                      // GOLD_p[2]=泥碼
            0                        // GOLD_p[3]=鑽石
        ]
    }
}
                                        
                                    

取得玩家投注記錄

• API 名稱 /v2/agent/get_bet_log
• 請求協議 POST
• 注意事項
  • 1.每個小時不能超過60次請求
  • 3.開始時間必須小於結束時間
  • 4.開始時間和結束時間間隔不能超過12個小時
  • 5.最多獲取距離今天往前推十天內的數據（以日為單位)

傳入參數

返回結果

Bet_log

傳入參數 範例

    
{
    "Agent_name": "PM0100001",                      // 代理商別名
    "Start_timestamp": 1729440000,                  // 查詢的起始點戳記(UTC秒數)
    "End_timestamp": 1729461600,                    // 查詢的結束點戳記(UTC秒數)
    "Search_page": 0,                               // 查詢的頁數 預設 第0頁
    "Search_count": 1,                              // 查詢的數量(單次上限最多1000筆)
    "Timestamp": 1729569008,                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "cf0d2ed789096f9f8abd25de34a249a6" // 簽名
}
                                        
                                    

返回結果 範例

    
{
    "Error_code": 1,                            // 錯誤碼
    "Msg": "Success",                           // 訊息
    "Total_count": 52372,                       // 總筆數
    "Page_no": 0,                               // 查詢頁碼
    "Page_size": 1,                             // 該頁數量
    "Bet_log": [                                // 投注記錄
        {
            "Bet_id": "169872366254559232",     // 注單號
            "Account": "aubree85",              // 玩家帳號
            "Date_time": 1748301365,            // 牌局結束時間
            "Round_id": "4_1790260575989",      // 牌局ID
            "Game_name": "AoF-NLH",             // 玩法
            "Gold_add": -15869575,              // 玩家輸贏
            "Pots": 33069150,                   // 底池總金額(單位0.0001)
            "Bets": 15869575,                   // 壓注總金額(單位0.0001)
            "Hands_card": "10,61",              // 手牌
            "Board_card_0": "26,24,51,67,64",   // 公牌-1
            "Board_card_1": "",                 // 公牌-2
            "Board_card_2": "",                 // 公牌-3
            "EV_revenue": 0,                    // EV 盈虧
            "EV_split": 10000,                  // EV分成比例
            "Rake_gold": 793478,                // 玩家該局抽水
            "Rake_split": 10000                 // 抽水分成比例
            "Start_Date_time": 1748301343,      // 牌局開始時間
            "Rake": 500,                        // 總抽水比例(玩家該局抽水比例)
            "Rake_amount": 793478               // 總抽水金額(玩家該局實際被抽的總金額)
        }
    ]
}


                            
                           

取得其他營收記錄

• API 名稱 /v2/agent/get_profit_log
• 請求協議 POST
• 注意事項
  • 1.每個小時不能超過60次請求
  • 3.開始時間必須小於結束時間
  • 4.開始時間和結束時間間隔不能超過12個小時
  • 5.最多獲取距離今天往前推十天內的數據（以日為單位)

傳入參數

返回結果

Profit_log

傳入參數 範例

    
{
    "Agent_name": "PM0100001",                      // 代理商別名
    "Start_timestamp": 1729440000,                  // 查詢的起始點戳記(UTC秒數)
    "End_timestamp": 1729461600,                    // 查詢的結束點戳記(UTC秒數)
    "Search_page": 0,                               // 查詢的頁數 預設 第0頁
    "Search_count": 1,                              // 查詢的數量(單次上限最多1000筆)
    "Timestamp": 1729569008,                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "cf0d2ed789096f9f8abd25de34a249a6" // 簽名
}
                                        
                                    

返回結果 範例

    
{
    "Error_code": 1,                            // 錯誤碼
    "Msg": "Success",                           // 訊息
    "Total_count": 52372,                       // 總筆數
    "Page_no": 0,                               // 查詢頁碼
    "Page_size": 1,                             // 該頁數量
    "Profit_log": [                             // 其他營收記錄
        {
            "Order_id": "s134758880470241280",  // 訂單號碼
            "Account": "skyray17",              // 玩家帳號     
            "Cause": 5,                         // 交易類型
            "Shop_revenue": 39920,              // 商城收益
            "Shop_split": 5000,                 // 商城分成比例
            "Host_withdrawal": 0,               // 房主提領
            "Deposit": 0,                       // 上分
            "Withdrawal": 0,                    // withdrawal
            "Date_time": 1739929539             // 交易時間
        }
    ]
}
                                        
                                    

查詢單一玩家上下分紀錄

• API 名稱 /v2/agent/get_player_records
• 請求協議 POST

傳入參數

返回結果

傳入參數 範例

        
{
    "Agent_name": "PM0100001",                      // 代理商別名
    "Order_id": "202508221626370001",               // 訂單號碼
    "Timestamp": 1729569008,                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
    "Signature": "cf0d2ed789096f9f8abd25de34a249a6" // 簽名
}
                                
                            

返回結果 範例

    
{
    "Error_code": 1,                            // 錯誤碼
    "Msg": "Success",                           // 訊息
    "Account": "skyray17",                      // 玩家帳號     
    "Order_id": "202508221626370001",           // 訂單號碼
    "Cause": 1,                                 // 交易類型
    "Gold_add": 500000,                         // 交易金額(單位0.0001)
    "Date_time": 1739929539                     // 交易時間
}
        
    

取得玩家餘額

• 由代理商提供 API URL
• 請求協議 POST

傳入參數

返回結果

Data

傳入參數 範例

	
{
	"Account": "account001",                        // 玩家帳號
	"Timestamp": 1741758634,                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
	"Signature": "a11f0141bf5f28869b02d60d540947b2" // 簽名
}                                   
										
									

返回結果 範例

	
{
	"Error_code": 1,                                // 錯誤碼 (成功 = 1; 失敗用負值)
	"Msg": "",                                      // 訊息
	"Data": {                                       // 內文
		"Account": "account001",                    // 玩家帳號
		"Balance": 10000000,                        // 玩家餘額
		"Currency": 1                               // 幣別，目前只有 1 = USD
	}

}
										
									

存款

• 由代理商提供 API URL
• 請求協議 POST

傳入參數

返回結果

Data

傳入參數 範例

	
{
	"Account": "account001",                        // 玩家帳號
	"Currency": 1,									// 幣別，目前只有 1 = USD
	"Cause": 11,										// 金流異動原因
	"Id": "test-transaction-id-0001",				// 該筆交易之unique id
	"Amount": 10000,								// 存款金額 (單位0.0001)
	"Time": 1741764561,							    // 交易發生時間(是一個UTC秒數)
	"Timestamp": 1741758634,                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
	"Signature": "a11f0141bf5f28869b02d60d540947b2" // 簽名
}                                   
										
									

返回結果 範例

	
{
	"Error_code": 1,                                // 錯誤碼 (成功 = 1; 失敗用負值)
	"Msg": "",                                      // 訊息
	"Data": {                                       // 內文
		"Account": "account001",                    // 玩家帳號
		"Balance": 10000000,                        // 玩家餘額
		"Currency": 1                               // 幣別，目前只有 1 = USD
	}

}
										
									

扣款

• 由代理商提供 API URL
• 請求協議 POST

傳入參數

返回結果

Data

傳入參數 範例

	
{
	"Account": "account001",                        // 玩家帳號
	"Currency": 1,									// 幣別，目前只有 1 = USD
	"Cause": 10,									// 金流異動原因
	"Id": "test-transaction-id-0001",				// 該筆交易之unique id
	"Amount": 10000,								// 扣款金額(單位0.0001)
	"Time": 1741764561,							    // 交易發生時間(是一個UTC秒數)
	"Timestamp": 1741758634,                        // 時間戳(是一個UTC秒數， 與Server之間的誤差不得超過60秒)
	"Signature": "a11f0141bf5f28869b02d60d540947b2" // 簽名
}                                    
										
									

返回結果 範例

	
{
	"Error_code": 1,                                // 錯誤碼 (成功 = 1; 失敗用負值)
	"Msg": "",                                      // 訊息
	"Data": {                                       // 內文
		"Account": "account001",                    // 玩家帳號
		"Balance": 10000000,                        // 玩家餘額
		"Currency": 1                               // 幣別，目前只有 1 = USD
	}

}
										
									

ASP.NET (C#)

        
using System.Net;
using System.Net.Http.Json;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;

namespace Sample
{
    internal class Program
    {
        private static async Task Main(string[] args)
        {
            var url = "http://172.31.34.66:9004/v2/agent/player_login";
            var agentName = "代理商別名";
            var secretKey = "聯絡我們取得代理商的安全密鑰";
            var account = "玩家帳號";
            var timeStamp = DateTimeOffset.UtcNow.ToUnixTimeSeconds();

            var playerLoginApiEntity = new
            {
                Agent_name = agentName，
                Account = account，
                Timestamp = timeStamp，
                Signature = $"{secretKey}{agentName}{account}{timeStamp}".GetMd5Hash()
            };

            var jsonPayload = JsonSerializer.Serialize(playerLoginApiEntity);
            var code = AES256CBCEncryptor.EncryptAES256CBCByText(agentName， jsonPayload， secretKey);

            var entity = new
            {
                Agent_name = agentName，
                Code = code
            };

            var requestContent = JsonSerializer.Serialize(entity);
            var content = new StringContent(requestContent， Encoding.UTF8， "application/json");

            var request = new HttpRequestMessage
            {
                Method = HttpMethod.Post，
                Content = content，
                RequestUri = new Uri($"{url}")
            };

            var response = await new HttpClient().SendAsync(request);
            var responseContent = await response.Content.ReadFromJsonAsync<PlayerLoginResponseEntity>();

            if (response.StatusCode == HttpStatusCode.OK)
            {
                if (responseContent.Error_code == 1)
                {

                }
            }
            else
            {

            }
        }

        private class PlayerLoginResponseEntity
        {
            public int Error_code { get; set; }
            public string Msg { get; set; } = string.Empty;
            public string Token { get; set; } = string.Empty;
        }
    }

    public static class MD5Extension
    {
        public static string GetMd5Hash(this string input)
        {
            using (MD5 md5 = MD5.Create())
            {
                byte[] hashBytes = md5.ComputeHash(Encoding.UTF8.GetBytes(input));
                StringBuilder sb = new StringBuilder();
                for (int i = 0; i < hashBytes.Length; i++)
                {
                    sb.Append(hashBytes[i].ToString("x2"));
                }
                return sb.ToString();
            }
        }
    }

    public static class AES256CBCEncryptor
    {
        public static string EncryptAES256CBCByText(string uid， string data， string secretKey)
        {
            byte[] key = Encoding.UTF8.GetBytes(secretKey);
            byte[] iv = new byte[16];
            using (var rng = new RNGCryptoServiceProvider())
            {
                rng.GetBytes(iv);
            }

            using (Aes aes = Aes.Create())
            {
                aes.Key = key;
                aes.IV = iv;
                aes.Mode = CipherMode.CBC;
                aes.Padding = PaddingMode.PKCS7;

                ICryptoTransform encryptor = aes.CreateEncryptor(aes.Key， aes.IV);

                using (var msEncrypt = new System.IO.MemoryStream())
                {
                    using (var csEncrypt = new CryptoStream(msEncrypt， encryptor， CryptoStreamMode.Write))
                    {
                        using (var swEncrypt = new StreamWriter(csEncrypt))
                        {
                            swEncrypt.Write(data);
                        }
                        byte[] encrypted = msEncrypt.ToArray();
                        string code = Convert.ToBase64String(iv.Concat(encrypted).ToArray());

                        return code;
                    }
                }
            }
        }
    }
}

                                    
                                  

PHP

                                                 
class AES256CBCEncryptor
{
    public static function convertUnicodeToUtf8($data)
    {
        return preg_replace_callback('/\\\\u([0-9a-fA-F]{4})/'， function ($matches) {
            return mb_convert_encoding(pack('H*'， $matches[1])， 'UTF-8'， 'UCS-2BE');
        }， $data);
    }

    public static function encryptAES256CBCByText($data， $secretKey)
    {
        $key = $secretKey;
        $iv = openssl_random_pseudo_bytes(16);

        $ciphertext = openssl_encrypt($data， 'aes-256-cbc'， $key， OPENSSL_RAW_DATA， $iv);
        $encrypted = base64_encode($iv . $ciphertext);

        return $encrypted;
    }
}

function getMd5Hash($input)
{
    return md5($input);
}

$url = "http://172.31.34.66:9004/api/v2/agent/player_login";
$agentName = "代理商別名";
$secretKey = "聯絡我們取得代理商的安全密鑰";
$account = "玩家帳號";
$timeStamp = time();

$playerLoginApiEntity = [
    "Agent_name" => $agentName，
    "Account" => $account，
    "Timestamp" => $timeStamp，
    "Signature" => getMd5Hash($secretKey . $agentName . $account . $timeStamp)
];

$jsonPayload = json_encode($playerLoginApiEntity);
$code = AES256CBCEncryptor::encryptAES256CBCByText($jsonPayload， $secretKey);

$entity = [
    "Agent_name" => $agentName，
    "Code" => $code
];

$options = [
    'http' => [
        'header'  => "Content-type: application/json\r\n"，
        'method'  => 'POST'，
        'content' => json_encode($entity)
    ]
];

$context  = stream_context_create($options);
$response = file_get_contents($url， false， $context);
$applyResponse = json_decode($response);

if ($http_response_header[0] === 'HTTP/1.1 200 OK') {
    if ($applyResponse->Error_code == 1) {
    }
} else {
}




                                          
                                          

Node.js

        
const crypto = require('crypto');
const axios = require('axios');

const agentName = '代理商別名';
const secretKey = '聯絡我們取得代理商的安全密鑰';
const account = '玩家帳號';
const url = 'http://172.31.34.66:9004/api/v2/agent/player_login';
const timeStamp = Math.floor(Date.now() / 1000);

function getMd5Hash(input) {
    return crypto.createHash('md5').update(input).digest('hex');
}

function encryptAES256CBCByText(data， secretKey) {
    const key = Buffer.from(secretKey， 'utf8');
    const iv = crypto.randomBytes(16);
    const cipher = crypto.createCipheriv('aes-256-cbc'， key， iv);
    let encrypted = cipher.update(data， 'utf8'， 'base64');
    encrypted += cipher.final('base64');
    return Buffer.concat([iv， Buffer.from(encrypted， 'base64')]).toString('base64');
}

(async () => {
    const playerLoginApiEntity = {
        Agent_name: agentName，
        Account: account，
        Timestamp: timeStamp，
        Signature: getMd5Hash(`${secretKey}${agentName}${account}${timeStamp}`)
    };

    const jsonPayload = JSON.stringify(playerLoginApiEntity);
    const code = encryptAES256CBCByText(jsonPayload， secretKey);

    const entity = {
        Agent_name: agentName，
        Code: code
    };

    const response = await axios.post(url， entity， {
        headers: {
            'Content-Type': 'application/json'
        }
    });

    const applyResponse = response.data;
    if (response.status === 200) {
        if (applyResponse.Error_code === 1) {
            console.log('Success:'， applyResponse);
        }
    } else {
        console.log('Failed:'， applyResponse);
    }

})();
                                            
                                            

附錄 - 錯誤訊息代碼

附錄 - 撲克牌編號