Action 82: Search Spribe Free Spin Reward Event Info

Function Description

This action is dedicated to the Spribe game provider and can only be used to query free spin reward events created via Action 80.
The search range is filtered by the event start time (startTime ~ endTime).
startTime must not be earlier than 180 days before the current time.
The values of ss.sss(seconds.milliseconds) in start time and end time must be 00.000.
The maximum time range for each search is 1 day.

Parameter

Parameter	Format	Mandatory	Description
action	Integer	Y	82
ts	Long	Y	Current system time
parent	String(50)	Y	Agent ID
startTime	String	Y	Start time of the searching range for the event start time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm `startTime must not be more than 180 days ago.`
endTime	String	Y	End time of the searching range for the event start time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
uid	String(50)	N	Player ID
status	Integer	N	Free Spin Reward Event Status CANCELED：0 CREATED：1 PAID：2
eventId	String(36)	N	Free Spin Reward Event Identifier (UUID v4 format, e.g. `550e8400-e29b-41d4-a716-446655440000`)
machineTypes	Integer Array	N	Machine Types (must all be Spribe games) See Game List (4.2) in appendix

Example


{
  "action": 82,
  "ts": 1711555200000,
  "parent": "testag",
  "uid": "player1",
  "startTime": "2024-07-22T04:05:00.000+01:00",
  "endTime": "2024-07-23T04:05:00.000+01:00",
  "status": 1,
  "eventId": "550e8400-e29b-41d4-a716-446655440000",
  "machineTypes": [22001]
}

Return Results

Parameter	Format	Description
status	String(4)	Success: 0000 Error: See Error Codes in Appendix `No Data: 0000`
data	JSON Array	`The returned listed in the following table.`
err_text	String(255)	Error message

Spribe Free Spin Reward Event Info

Parameter	Format	Description
eventId	String	Free Spin Reward Event ID (UUID v4 format)
name	String	Free Spin Reward Event Name
machineType	Integer	Machine Type See Game List (4.2) in appendix
status	String	Free Spin Reward Event Status CANCELED: Cancelled CREATED: Created (not yet paid) PAID: Paid
currency	String	Currency See Currency Code
bet	String	Free Spin Reward Bet Amount per Spin
times	Integer	Free Spin Reward Available Times
startTime	String	Free Spin Reward Event Start Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
endTime	String	Free Spin Reward Event End Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
createTime	String	Free Spin Reward Event Create Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
updateTime	String	Free Spin Reward Event Update Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
cashoutTime	String	Free Spin Reward Event Cashout Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm `This field is only set when the event status is PAID, otherwise it is null`

Operation Sample


// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
 
// Http Response (success)
{
    "status": "0000",
    "data": [
        {
            "eventId": "550e8400-e29b-41d4-a716-446655440000",
            "name": "TEST SPRIBE EVENT NAME",
            "machineType": 22001,
            "status": "CREATED",
            "currency": "RB",
            "bet": "2.000",
            "times": 10,
            "startTime": "2024-07-22T04:05:33.000+01:00",
            "endTime": "2024-07-22T23:59:59.000+01:00",
            "createTime": "2024-07-22T03:00:00.000+01:00",
            "updateTime": "2024-07-22T03:00:00.000+01:00",
            "cashoutTime": null
        },
        {
            "eventId": "660e8400-e29b-41d4-a716-446655440111",
            "name": "ANOTHER SPRIBE EVENT",
            "machineType": 22003,
            "status": "PAID",
            "currency": "RB",
            "bet": "1.500",
            "times": 5,
            "startTime": "2024-07-20T08:00:00.000+01:00",
            "endTime": "2024-07-21T08:00:00.000+01:00",
            "createTime": "2024-07-20T07:30:00.000+01:00",
            "updateTime": "2024-07-21T08:05:12.000+01:00",
            "cashoutTime": "2024-07-21T08:05:12.000+01:00"
        }
    ]
}
 
// Http Response (no data)
{
    "status": "0000",
    "data": []
}
 
// Http Response (failed)
1. If query player is not a downline of the agent:
{
    "status": "7501",
    "err_text": "User ID cannot be found."
}
 
2. If startTime is greater than endTime:
{
    "status": "8000",
    "err_text": "The parameter of input error, please check your parameter is correct or not. parameter:startTime must not be after endTime."
}
 
3. If startTime is more than 180 days ago:
{
    "status": "8000",
    "err_text": "The parameter of input error, please check your parameter is correct or not. parameter:startTime must not be more than 180 days ago."
}
 
4. If machineTypes contains a game that does not belong to Spribe:
{
    "status": "8000",
    "err_text": "The parameter of input error, please check your parameter is correct or not. parameter:machineTypes must all be valid Spribe games"
}