/
7.2 getFeatureBuy()

7.2 getFeatureBuy()

Owned by Iztok Stopar Ložar (Unlicensed)
Last updated: May 31, 2023

Get featurebuy rounds for the $game. They are valid until $validTo. You can search by multiple games

public getFeatureBuy( [ string $currency = string(0) "" ,string $featurebuy_id , string $games , string $validTo , string $validFrom = string(0) "" ] )

Parameters

  • string $currency = string(0) "" - Default = "EUR"
  • string $featurebuy_id string(0) - Value of the variable looks like 627a500001232103210. 
  • string $gameids required - Value of the variable looks like 787(id) or gs#gs-three-kings(title). 
  • string $validTo = string(0) "" - Default = + 1 week 
  • string $validFrom = string(0) "" - Default = ""
  • string $betLevel = string(0) "" - Default = "" - Possible values are: min, mid, max. It defines the cost of the bet during the freerounds

Required parameters: $validTo , $currency

Type of requests

  • If freeround_id is not set (Returns promotions)
Shows all freerounds that have been added for a specific game
Example: "gameids": "787", "validTo": "2023-03-30", "validFrom": "2020-02-24" → Lists all freeroundes added for the game: "787" and between the date "validFrom" and "validTo"
  • If featurebuy_id is set (Returns users for a specific promotion)
Shows all freeround that have been used for a specific freeround_id and in a specific game

The method return all featurebuys that have been added for a specific game and filtered by the freeround_id parameter

Example: "featurebuy_id": "627a500001232103210", "gameids": "787",   "validTo": "2023-03-30", "validFrom": "2020-02-24" → Lists all featurebuys added for the game: "787", for specific featurebuy_id and between the date "validFrom" and "validTo"


Request

REST REQUEST
Array
    (
        [api_password] => xapitest
        [api_login] => xapitest
        [method] => getFeatureBuy
		[featurebuy_id] => ""
        [gameids] => "787"
		[validFrom] => 2022-04-30
		[validTo] => 2022-11-30
		[betlevel] => "min"
		[currency] => EUR
    )


Response

REST RESPONSE

If freeround_id is not set: 

ON SUCCESS
{
	"error": 0,
	"response": [
		{
			"featurebuy_id": "64074db4163b0000e600515b",
			"players": [
				"1007497"
			],
			"games": [
				"qs#qs-artemis-vs-medusa",
				"qs#qs-artemis-vs-medusa-mobile"
			],
			"betLevel": "min",
			"validFrom": "2016-05-01 02:00:00",
			"validTo": "2023-04-30 01:59:59",
			"created": "2023-03-07 15:44:04",
			"received": 0
		},
		{
			"featurebuy_id": "64075295163b0000e6005173",
			"players": [
				"1007497"
			],
			"games": [
				"qs#qs-artemis-vs-medusa",
				"qs#qs-artemis-vs-medusa-mobile"
			],
			"betLevel": "min",
			"validFrom": "2016-05-01 02:00:00",
			"validTo": "2023-04-30 01:59:59",
			"created": "2023-03-07 16:04:53",
			"received": 0
		}
	],
	"currency": "EUR"
}

If freeround_id is set: 

ON SUCCESS
{
	"error": 0,
	"response": [
		{
			"featurebuy_id": "64074db4163b0000e600515b",
			"player": "1007497",
			"games": [
				"qs#qs-artemis-vs-medusa",
				"qs#qs-artemis-vs-medusa-mobile"
			],
			"betLevel": "min",
			"validFrom": "2016-05-01 02:00:00",
			"validTo": "2023-04-30 01:59:59",
			"created": "2023-03-07 15:44:04",
			"used": 0,
			"activated": null,
			"activatedDate": null,
			"win": null,
			"completed": false
		}
	],
	"currency": "EUR"
}
ON ERROR
{
	"error": 1,
	"message": "unknown command"
}


Source Code
public function getFeatureBuy($featurebuy_id, $games, $validTo, $validFrom = '', $betLevel = ''){
	return $this->client->getFeatureBuy($featurebuy_id, $games, $validTo, $validFrom, $betLevel);
}

Related content