Purpose:
It returns the money ammount that the loged account has. In adition it returns the privilege attributes, the same returned by _LOGIN o _RELOGIN, so this can save one API call.
If the target server belongs to a clan, and the servers shares the ammounts (an user can deposit cash in one establishment, and then use it in another establishment), this function will forward a request to the others servers to re-synchronize before returning this information, so, depends on the scenario, it can take a bit longer. But if the account is in use in another server, that another server can deny the access to resynchronize and an error will pop.
Minimum version for the target server required: v17.0.7.
Input parameter:
- CommandClass = _GETUSERDATA1
- Param1 = target CyberName.
- Param2 = Session Token.
Output:
[{“ResponseClass”: “ERROR”, “Param1”: “message”, … }]
[{“ResponseClass”: “MONEY”, “Param1”: “Money”, “Param2”: “Raw Money”, “Param3”: “Currency Símbol” }]
[{“ResponseClass”: “OK”, “Param1”: “Attribs” }]
NOTE: The ammount that returns in “Param1” is textually formatted by the regional configuration of the target server, by example, the decimal dot can be a punctuation comma, and the cents format is also formmated by the target server, ready to show as string in the screen. The textual currency symbol to use from the target server configuration is found in “Param3”.
While in “Param2” it is in raw format for normal math currency functions and as it is not rounded it maybe has silly longer decimals.
Example of usage: