Milkyway

Terminal agent API: login, users, passwords, recharge, redeem and records.

Base URL: https://milkywayapp.xyz:8033/ws/service.ashx
Authentication: Agent login, then MD5 sign
Sections: 12

MW Terminal API-v1.2.2- En.docx DOCX, 43 KB

Introduction#

MW Terminal API v1.22

API URL#

URL : https://milkywayapp.xyz:8033/ws/service.ashx

API Notes#

When calculating sign, all strings should convert to lowercase。
The length of string should not exceed 63 bits

URL: /ws/service.ashx?action=agentLogin

Request: (Method: POST)

parameter	type	necessity	description
agentName	string	required	Agent name
agentPasswd	string	required	Agent password after being encrypted by MD5
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())

Response

parameter	type	description
code	int	Result code（200:success，201:failure）
msg	string	If result code is 201, this field will show message to tell the reason，Otherwise, there is no such field.
agentKey	string	Use this field to calculate signature in subsequent API（notice:This field will change every time after the API agentLogin is successfully called）
Balance	int	The balance of agent

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=agentLogin&agentName=agent01&agentPasswd=e10adc3949ba59abbe56e057f20f883e&time=1598452539

call specifications: less than 30 times per minutes(< 30/M)

change 30->1000

Register User Account#

URL: /ws/service.ashx?action=registerUser

Request: (Method: POST)

parameter	type	necessity	description
account	string	required	Account of players,The length should be between 6 to 32 chars.
passwd	string	required	Player password after being encrypted by MD5
agentName	string	required	Agent name
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	=md5(agentName+time+agentKey)

Notice：When calculating sign, all strings should convert to lowercase,for example:

Md5(agentName.toLower() + time.toString()+agentKey.toLower())

Response

parameter	type	description
code	int	Result code（200:success，201:failure）
msg	string	If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=registerUser&account=test01&passwd=e10adc3949ba59abbe56e057f20f883e&agentName=agent01&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

call specifications: less than 30 times per minutes(< 30/M) change 30 to 1000

Query User Information#

URL: /ws/service.ashx?action=queryInfo

Request: (Method: POST)

parameter	type	necessity	description
account	string	required	Account of players,The length should be between 6 to 32 chars.
passwd	string	required	Player password after being encrypted by MD5
agentName	string	required	Agent name
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	md5(agentName+time+agentKey)

Response

parameter	type	description
code	int	Result code（200:success，201:failure）
msg	string	If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.
agentBalance	int	The balance of agent.
gameId	int	The game id of user.
userbalance	int	The balance of user.
webLoginUrl	string	The quick login url for web game. Referrence: http://play.milkywayapp.xyz/?OdGUUuFv+P0tyZjRXVrsOBWOvHe66hjtOpLjR4YDeLnQvmCLSh7t53rIB6bm7Kw8

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=queryInfo&account=test01&passwd=e10adc3949ba59abbe56e057f20f883e&agentName=agent01&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

call specifications: less than 30 times per minutes(< 30/M)

change 30 to 1000

Change The Password Of User#

URL: /ws/service.ashx?action=changePasswd

Request: (Method: POST)

parameter	type	necessity	description
account	string	required	Account of players,The length should be between 6 to 32 chars.
passwd	string	required	Player password after being encrypted by MD5
passwdNew	string	required	New player password after being encrypted by MD5
agentName	string	required	Agent name
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	=md5(agentName+time+agentKey)

Response

parameter	type	description
code	int	Result code（200:success，201:failure）
msg	string	If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=changePasswd&account=test01&passwd=e10adc3949ba59abbe56e057f20f883e&passwdnew=e10adc3949ba59abbe56e057f20f883e&agentName=agent01&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

call specifications: less than 30 times per minutes(< 30/M)

change 30 to 1000

Recharge#

URL: /ws/service.ashx?action=recharge

Request: (Method: POST)

parameter	type	necessity	description
account	string	required	Account of players,The length should be between 6 to 32 chars.
amount	int	required	Amount to be recharged
agentName	string	required	Agent name
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	=md5(agentName+time+agentKey)

Response

parameter	type	description
code	int	Result code（200:success，201:failure）
msg	string	If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=recharge&account=test01&amount=1&agentName=agent01&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

Notice：After recharged or redeemed through the terminal API successfully, Remark field of Transaction Detail in web management system will be recorded as ‘terminal’+timestamp.

call specifications: less than 30 times per minutes(< 30/M)

change 30 to 1000

Redeem#

URL: /ws/service.ashx?action=redeem

Request: (Method: POST)

parameter	type	necessity	description
account	string	required	Account of players,The length should be between 6 to 32 chars.
amount	int	required	Amount to be redeemed.
agentName	string	required	Agent name
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	=md5(agentName+time+agentKey)

Response

parameter	type	description
code	int	Result code（200:success，201:failure）
msg	string	If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=redeem&account=test01&amount=1&agentName=agent01&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

call specifications: less than 30 times per minutes(< 30/M)

change 30 to 1000

Get trade record#

URL: /ws/service.ashx?action=getTradeRecord

Request: (Method: POST)

parameter	type	necessity	description
agentName	string	required	Agent name
account	string	required	Account of players,The length should be between 6 to 32 chars.
fromDate	string	required	The start time of this query.
toDate	string	required	End time of this query
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	=md5(agentName+time+agentKey)

Notice:The time span between “fromDate” and “toDate” should be less than 1 month. You can only query the transaction records within 1 month from the current time at most.

Response

parameter type description

code int Result code（200:success，201:failure）

data

json

[{"account":"tian22","gameId":100131,"balanceBefore":100.00,"score":-50.00,"insertTime":"2023/5/4 11:51:09"}]

Data field explanation
balanceBefore:balance before redeem or recharge.
insertTime: redeem/recharge date.

msg string If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=getTradeRecord&account=test01&agentName=agent01&fromDate=2023-04-01 00:00:00&toDate=2023-05-01 00:00:00&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

Notice：

the ”insertTime” in data field is Beijing time.
If the “score” in data field is positive, it indicates recharge action, and if it is negative, it indicates redeem action.

call specifications: less than 10 times per minutes(< 10/M)

change 30 to 1000

Get Jp record#

URL: /ws/service.ashx?action=getJpRecord

Request: (Method: POST)

parameter	type	necessity	description
agentName	string	required	Agent name
account	string	required	Account of players,The length should be between 6 to 32 chars.
fromDate	string	required	The start time of this query.
toDate	string	required	The end time of this query.
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	=md5(agentName+time+agentKey)

Notice:The time span between “fromDate” and “toDate” should be less than 1 month.

Response

parameter	type	description
code	int	Result code（200:success，201:failure）
data	json	`[{"account":"test112","gameId":100283,"type":"Mini","score":26.13,"insertTime":"2023/5/4 9:31:02"}]`
msg	string	If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=getjprecord&account=test01&agentName=agent01&fromdate=2023-04-01 00:00:00&todate=2023-05-01 00:00:00&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

Notice：the ”insertTime” in data field is Beijing time.

call specifications: less than 10 times per minutes(< 10/M)

change 30 to 1000

Get game record#

URL: /ws/service.ashx?action=getGameRecord

Request: (Method: POST)

parameter	type	necessity	description
agentName	string	required	Agent name
account	string	required	Account of players,The length should be between 6 to 32 chars.
time	long	required	Time stamp(refer to C # api System.currentTimeMillis())
sign	string	required	=md5(agentName+time+agentKey)

Response

parameter type description

code int Result code（200:success，201:failure）

data

json

[{"account":"test102","gameId":100567,"balanceBefore":11112.79,"totalPlayed":0.10,"totalWin":0.40,"balanceNow":11113.19,"reason":"Exit Game","insertTime":"2023/5/4 12:21:58"}]
Data field explanation
balanceBefore:balance before game.
totalPlayed: total played.
totalWin: total win.
balanceNow: balance now.
Reason: Recording notes.
insertTime:Recording time.

msg string If result code is 201 this field will show message to tell the reason，Otherwise, there is no such field.

reference：

https://milkywayapp.xyz:8033/ws/service.ashx?action=getGameRecord&account=test01&agentName=agent01&time=1598452539&sign=7b35f60db33dcfd237fdb48cb5de97c5

Notice：Game records can be traced back to for the last 7 days from current time. Change 7 to 15, at least or above.

call specifications: less than 10 times per minutes(< 10/M)

change 30 to 1000

Introduction#

API URL#

API Notes#

Agent Login#

Register User Account#

Query User Information#

Change The Password Of User#

Recharge#

Redeem#

Get trade record#

Get Jp record#

Get game record#