game/getPreferences is used to retrieve one or more values. The values are only available to the currently logged-in user for the specified game. Users must be logged in to make use of the method.

game/getPreferences is available at http://api.kidswb.com/data/game/getPreferences, and like most data API methods, accepts parameters via GET or POST (where POST is preferred).

While userID and sessionID are not parameters you need explicitly send, a valid matching set are required and expected to be passed via cookies to the request.

Parameters
Name Required Type Range Comments
asyncToken no string 0 - 128 chars Returns any value passed in the response. Can be used by client to identify which request this is the response for.
game YES string n/a game slug for the applicable game
names YES Pipe-separated strings 0 - 128 chars per name "|"-separated list of preference names.

Sample Results

Successful Execution

{
	"result": "ok",
	"values": {
		"name1": "value1",
		"name2": "value2"
	}
}

Successful Execution w/asyncToken

{
	"result": "ok",
	"values": {
		"name1": "value1",
		"name2": "value2"
	},
	"asyncToken": "sampleAsyncToken"
}

Unsuccessful Execution invalid parameters

{
	"result": "error",
	"error": {
		"errorNum": 10000,
		"errorMsg": "Invalid Parameters"
	}
}

Unsuccessful Execution invalid user session

{
	"result": "error",
	"error": {
		"errorNum": 10100,
		"errorMsg": "Invalid User Session"
	}
}

Unsuccessful Execution invalid game id

{
	"result": "error",
	"error": {
		"errorNum": 10200,
		"errorMsg": "Invalid Game"
	}
}