API Documents Archives

GetActiveGameList

查询已开放的游戏清单。游戏清单结构例子:

<GameList>
     <Game>
        <GameCode>EG-FISHING-001</GameCode>
        <GameName>Fishermen Gold</GameName>
        <GameType>multiplayer</GameType>
        <Enabled>true</Enabled>
     </Game>
</GameList>

<Game>

<GameCode>EG-FISHING-001</GameCode>

<GameName>Fishermen Gold</GameName>

<GameType>multiplayer</GameType>

</Game>

</GameList>

GetActiveGameList

API Documents / By apiwebservice

Check the list of active games. GameList example:

<GameList>
     <Game>
        <GameCode>EG-FISHING-001</GameCode>
        <GameName>Fishermen Gold</GameName>
        <GameType>multiplayer</GameType>
        <Enabled>true</Enabled>
     </Game>
</GameList>

<Game>

<GameCode>EG-FISHING-001</GameCode>

<GameName>Fishermen Gold</GameName>

<GameType>multiplayer</GameType>

</Game>

</GameList>

GetFishingDetailsURL

API Documents / By apiwebservice

This web service will generate the URL for displaying the fishing game details by BetID

GetFishingGameDetails

API Documents / By apiwebservice

This Web service will fetch bet details for one fishing game session.

<?xml version="1.0" encoding="utf-8"?>
<GetFishingGameDetailsResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorMsgId>0</ErrorMsgId>
  <ErrorMsg>Success</ErrorMsg>
  <BetAmount>4697</BetAmount>
  <WinAmount>6985.5</WinAmount>
  <Currency>THB</Currency>
  <ExchangeRate>1</ExchangeRate>
  <Count>240</Count>
  <ItemCount>20</ItemCount>
  <GameName>Lustrous Ocean</GameName>
  <Limit>20</Limit>
  <BulletDetailsList>
    <BulletDetails>
      <Denom>0.5</Denom>
      <ID>87031139</ID>
      <Multiplier>2</Multiplier>
      <Cost>1</Cost>
      <Reward>2.5</Reward>
      <Species>29</Species>
      <FreeBulletTotal>0</FreeBulletTotal>
      <FreeBulletRemain>0</FreeBulletRemain>
      <CreatedAt>2021-08-11 17:09:29</CreatedAt>
      <FreeBulletReward>0</FreeBulletReward>
      <FreeBulletMultiplier>0</FreeBulletMultiplier>
    </BulletDetails>
    ............
    ............
    ............ 
  </BulletDetailsList>
</GetFishingGameDetailsResponse>

<?xml version="1.0" encoding="utf-8"?>

<ErrorMsg>Success</ErrorMsg>

<GameName>Lustrous Ocean</GameName>

</BulletDetails>

............

</BulletDetailsList>

</GetFishingGameDetailsResponse>

This Web service will fetch the unfinished slot game of a user. The API only gets the unfinished game within 10 days. The frequency of the call should be made to this API 10 times per 1 second otherwise it will throw an error. output:

<?xml version="1.0" encoding="utf-8"?>
<GetUnfinishedGameResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Username>DemoUser001</Username>
    <UnfinishedGameDetailList>
        <UnfinishedGameDetail>
            <GameCode>EG-SLOT-A036</GameCode>
            <BetAmount>10</BetAmount>
        </UnfinishedGameDetail>
        <UnfinishedGameDetail>
            <GameCode>EG-SLOT-A038</GameCode>
            <BetAmount>20</BetAmount>
        </UnfinishedGameDetail>
        <UnfinishedGameDetail>
            <GameCode>EG-SLOT-C003</GameCode>
            <BetAmount>40</BetAmount>
        </UnfinishedGameDetail>
    </UnfinishedGameDetailList>
    <ErrorMsgId>0</ErrorMsgId>
    <ErrorMsg>Success</ErrorMsg>
</GetUnfinishedGameResponse>

<?xml version="1.0" encoding="utf-8"?>

<Username>DemoUser001</Username>

</UnfinishedGameDetail>

</UnfinishedGameDetail>

</UnfinishedGameDetail>

</UnfinishedGameDetailList>

<ErrorMsg>Success</ErrorMsg>

</GetUnfinishedGameResponse>

GetSlotDetailsURL

API Documents / By apiwebservice

This web service will generate the URL for display the game details by BetID or GameID. (Only one parameter either BetID or GameID will be accepted)

Usage of String q and s

API Documents / By apiwebservice

Your API received the q and s parameters should decode the q and verify it’s md5 with the s. If the verification passed, the client should check against their own system. If the username exists in your platform, you should call SA Gaming API “LoginRequest” to receive a login token for the user. If the …

Usage of String q and s Read More »

PHP version

API Documents / By apiwebservice

DES Encrypt/Decrypt function in PHP:

<?php
class DES
{
    var $key;
    var $iv;
    function DES( $key, $iv=0 ) {
        $this->key = $key;
        if( $iv == 0 ) {
            $this->iv = $key;
        } else {
            $this->iv = $iv;
        
    }

    function encrypt($str) {
        $size = mcrypt_get_block_size ( MCRYPT_DES, MCRYPT_MODE_CBC);
        $str = $this->pkcs5Pad ( $str, $size );
        return base64_encode( mcrypt_encrypt(MCRYPT_DES, $this->key, $str, MCRYPT_MODE_CBC, $this->iv ) );
 }
    function decrypt($str) {
        $str = mcrypt_decrypt(MCRYPT_DES, $this->key, base64_decode($str), MCRYPT_MODE_CBC, $this->iv);
        return rtrim($str, “\x1\x2\x3\x4\x5\x6\x7\x8”);
    }

    function pkcs5Pad($text, $blocksize) {
        $pad = $blocksize - (strlen ( $text ) % $blocksize);
        return $text . str_repeat ( chr ( $pad ), $pad );
    }
}
?>

<?php

class DES

{

var $key;

var $iv;

function DES( $key, $iv=0 ) {

$this->key = $key;

if( $iv == 0 ) {

$this->iv = $key;

} else {

$this->iv = $iv;

}

function encrypt($str) {

$size = mcrypt_get_block_size ( MCRYPT_DES, MCRYPT_MODE_CBC);

$str = $this->pkcs5Pad ( $str, $size );

return base64_encode( mcrypt_encrypt(MCRYPT_DES, $this->key, $str, MCRYPT_MODE_CBC, $this->iv ) );

}

function decrypt($str) {

$str = mcrypt_decrypt(MCRYPT_DES, $this->key, base64_decode($str), MCRYPT_MODE_CBC, $this->iv);

return rtrim($str, “\x1\x2\x3\x4\x5\x6\x7\x8”);

}

function pkcs5Pad($text, $blocksize) {

$pad = $blocksize - (strlen ( $text ) % $blocksize);

return $text . str_repeat ( chr ( $pad ), $pad );

}

MD5 function in PHP:

<?php
$str = "method=GetUserStatus&Key=01234567789ABCDEF0123456789ABCDE&Time=20150101012345&Username=abcd12345"; // for example
$md5key = "abcdefg"; // for example
$Time = "20150101012345"; // for example
$SecretKey = "01234567789ABCDEF0123456789ABCDE"; // for example
$PreMD5Str = $str . $md5key . $Time . $SecretKey;
$OutMD5 = md5($PreMD5Str);
echo "md5:[ $OutMD5 ]";
?>

<?php

$str = "method=GetUserStatus&Key=01234567789ABCDEF0123456789ABCDE&Time=20150101012345&Username=abcd12345"; // for example

$md5key = "abcdefg"; // for example

$Time = "20150101012345"; // for example

$SecretKey = "01234567789ABCDEF0123456789ABCDE"; // for example

$PreMD5Str = $str . $md5key . $Time . $SecretKey;

$OutMD5 = md5($PreMD5Str);

echo "md5:[ $OutMD5 ]";

ASP.Net C# version

API Documents / By apiwebservice

Example DES Encrypt/Decrypt function in ASP.Net C# :

protected byte[] EncryptKey = ASCIIEncoding.ASCII.GetBytes("ask_us_for_key");

public string DESEncrypt(string inString)
{
	MemoryStream ms = new MemoryStream();
CryptoStream cs = new CryptoStream(ms, new DESCryptoServiceProvider().CreateEncryptor(EncryptKey, EncryptKey), CryptoStreamMode.Write);
	StreamWriter sw = new StreamWriter(cs);
	sw.Write(inString);
	sw.Flush();
	cs.FlushFinalBlock();
	sw.Flush();
return Convert.ToBase64String(ms.GetBuffer(), 0, (int)ms.Length);
}

public string DESDecrypt(string inString)
{
    try
    {
return new StreamReader(new CryptoStream(new MemoryStream( Convert.FromBase64String(inString)), new DESCryptoServiceProvider().CreateDecryptor(EncryptKey, EncryptKey), CryptoStreamMode.Read)).ReadToEnd();
    }
    catch
    {
    }
    return "";
}

protected byte[] EncryptKey = ASCIIEncoding.ASCII.GetBytes("ask_us_for_key");

public string DESEncrypt(string inString)

{

MemoryStream ms = new MemoryStream();

CryptoStream cs = new CryptoStream(ms, new DESCryptoServiceProvider().CreateEncryptor(EncryptKey, EncryptKey), CryptoStreamMode.Write);

StreamWriter sw = new StreamWriter(cs);

sw.Write(inString);

sw.Flush();

cs.FlushFinalBlock();

sw.Flush();

return Convert.ToBase64String(ms.GetBuffer(), 0, (int)ms.Length);

}

public string DESDecrypt(string inString)

{

try

{

return new StreamReader(new CryptoStream(new MemoryStream( Convert.FromBase64String(inString)), new DESCryptoServiceProvider().CreateDecryptor(EncryptKey, EncryptKey), CryptoStreamMode.Read)).ReadToEnd();

}

catch

{

}

return "";

}

Example MD5 function in ASP.Net C#:

public string BuildMD5(string inString)
{
       byte[] hashed = MD5.Create().ComputeHash(Encoding.UTF8.GetBytes(inString));
       StringBuilder sb = new StringBuilder(hashed.Length * 2);
       for (int i = 0; i < hashed.Length; i++)
       {
            sb.Append(hashed[i].ToString("x2"));
       }
       return sb.ToString();
}

public string BuildMD5(string inString)

{

byte[] hashed = MD5.Create().ComputeHash(Encoding.UTF8.GetBytes(inString));

StringBuilder sb = new StringBuilder(hashed.Length * 2);

for (int i = 0; i < hashed.Length; i++)

{

sb.Append(hashed[i].ToString("x2"));

}

return sb.ToString();

}

Integration

API Documents / By apiwebservice

In order to let your player to log in through our mobile app, you have to implement a “User authentication interface” in your system to verify the player. In the mobile app, a player must log in by your platform’s username ending with ‘@’ and your unique suffix, which we will provide you. For example, …

Integration Read More »