Skip to main content

Interface Description

1. API Gateway Address​

Production Environment​

https://api.aig1234.com

Testing Environment​

https://staging.aig1234.com

2. Description​

  • Merchant ID and merchant private key can be obtained from customer service
  • Use Gzip compression uniformly
  • Use JSON data format uniformly, the message header should be "Content-Type: application/json"
  • The fixed values specified in the parameter names and parameter descriptions must be exactly the same as those in the list (case sensitive)

3. Wallet Description​

  • Transfer Wallet: The game side creates a wallet for each player and provides wallet transfer in/out interfaces for the merchant side to call. See "Wallet (Transfer Wallet)" for details
  • Single Wallet: The game side does not create a player's wallet. The merchant side implements the interface according to the "Wallet (Single Wallet)" interface format, and the game side calls the interface provided by the merchant side to query the balance

4. MD5 Signature Algorithm​

  • Set all sent or received data as set M, sort the non-empty parameter values in set M according to the parameter names in ascending order of ASCII code (dictionary order)
  • Use the URL key-value pair format, i.e., key1=value1&key2=value2..., to concatenate into a string. Note: Empty value parameters are not involved in the signature
  • Place the interface key in front of the string in step 1 and merge it together with "&"
  • Use md5 to calculate the summary of the string in the previous step (case insensitive), and pass this summary to the interface as the sign parameter
Post Request Example:​
  • Post request
  • Merchant private key is l4gnD61pz4arJyv8
  • The interface request parameters are as follows:
{
    "agent_id": "agent001",
    "user_id": "testUid03",
    "user_name": "testUser",
    "desc": "a test user",
    "timestamp": 1734486159402
}
  • According to the above algorithm, the result after concatenation is as follows:
l4gnD61pz4arJyv8&agent_id=agent001&desc=a test user&timestamp=1734486159402&user_id=testUid03&user_name=testUser
  • The summary result calculated from the above string is (case insensitive):
9d356beca8874e340721cc3e269863bd
  • When calling the interface, the complete parameters are:
curl --location 'https://staging.aig1234.com/api/member/create' \
--header 'Content-Type: application/json' \
--data '{
    "agent_id": "agent001",
    "user_id": "testUid03",
    "user_name": "testUser",
    "desc": "a test user",
    "timestamp": 1734486159402,
    "sign": "9d356beca8874e340721cc3e269863bd"
}'
Get Request Example:​
  • Get request
  • Merchant private key is l4gnD61pz4arJyv8
  • The interface request parameters are as follows:
https://staging.aig1234.com/api/game/transaction/latest?agent_id=agent001&last_time=1732589000000&timestamp=1734486354401
  • According to the above algorithm, the result after concatenation is as follows:
l4gnD61pz4arJyv8&agent_id=agent001&last_time=1732589000000&timestamp=1734486354401
  • The summary result calculated from the above string is (case insensitive):
c9657cf532400606b83513ec494c385f
  • When calling the interface, the complete parameters are:
https://staging.aig1234.com/api/game/transaction/latest?agent_id=agent001&last_time=1732589000000&timestamp=1734486354401&sign=c9657cf532400606b83513ec494c385f