Skip to content

Bonuses🔗

Study the “General Information” and the “Signature Verification” sections first.

For more information on what bonuses are, see the Bonuses section.

Returns a list of bonuses given to users.

Parameters🔗

Parameter Method Value Mandatory Type Description
action GET bonuses yes string Command
startTime GET 1406110188 no number Start time (unixtime)
endTime GET 1406110217 no number End time (unixtime)
openUDID GET 7a094f...36d0be064730c4 no string openUDID of the device to get a list of bonuses for
userId GET 87bdfd...75fdf2e0 no string ID of the user to get a list of bonuses for

To get a list of previously issued bonuses, you need to specify the time period. For example, to get a list of all bonuses for entire time, just set endTime to the current time. Specify OpenUDID or UserID to get a list bonuses for a specific player/device.

Error codes🔗

Code Description
-26 Unexpected error. Contact technical specialists.
-27 The application does not have a link to notify the game server.

Request example🔗

https://mrgs.astrum.team/pub/s2s.php?action=bonuses&appId=38&format=json&userId=e7b9bdd689f099cb0490ab6a25e0139b&hash=7a9bf540fb41389e152774164104728c

Bonuses ( Bonus keys are the internal bonus IDs, which are duplicated in each bonus - 'id' )

Parameter Type Description
userId string ID of the user for whom the bonus was issued
deviceId string ID of the device for which the bonus was issued
bonus_code string Bonus code
bonus_object_id number In-game resource ID
cnt number Quantity
rtime number Bonus receipt confirmation time (0 - if not received)

Response example🔗

{
    "status": 0,
    "error": "",
    "result": {
        "bonuses": {
            "2962965": {
                "id": "2962965",
                "userId": "6045610",
                "deviceId": "DFA0398F-41EF-4C87-ADCF-0A10D6DDCFE6",
                "bonus_code": "fbp_jw",
                "bonus_object_id": "66555",
                "cnt": "1",
                "rtime": "1580511537",
                "comment": "\u0412\u044b\u0434\u0430\u043d \u0431\u043e\u043d\u0443\u0441 \u0437\u0430 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0443 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f id: 306"
            },
            "2963235": {
                "id": "2963235",
                "userId": "6008830",
                "deviceId": "678390A4-AB04-431C-ACEC-B6E4A2C3EE88",
                "bonus_code": "fbp_jw",
                "bonus_object_id": "66555",
                "cnt": "1",
                "rtime": "1580555711",
                "comment": "\u0412\u044b\u0434\u0430\u043d \u0431\u043e\u043d\u0443\u0441 \u0437\u0430 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0443 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f id: 306"
            }
        }
    }
}
Last update: 2025-01-21
Created: 2020-02-17