Table of Contents
game.getByTag
Description
Returns a list of games related to the given tag. As for now, only one tag is authorized.
Parameters
| Required | Type | Name | Description |
|---|---|---|---|
| required | string | tag | Games with this tag will be returned |
| optional | int | number | Represent how many games will be returned. Default is 5 |
Error Codes
| Code | Description |
|---|---|
| 1 | something bad happened during process |
| 2 | tag is not a string or is not a valid tag |
| number is not an integer or is not a strictly positive number | |
| 3 | tag is not found into the database |
If an error occured, an xml with the error code and a brief summary are returned.
Please see this page for more details.
Request Example(s)
http://www.pictogame.com/services/public/?method=game.getByTag&tag=flower
http://www.pictogame.com/services/public/?method=game.getByTag&tag=arrow&number=10
Example Return XML
<?xml version="1.0" encoding="UTF-8" ?> <ResultSet totalResultsReturned="2" totalResultsAvailable="52"> <Result> <Username>foobar</Username> <Title>My game title</Title> <Description></Description> <Tags></Tags> <RatingAverage>4.6</RatingAverage> <RatingCount>12</RatingCount> <Views>415</Views> <Created>2007-12-04 17:22:54</Created> <Updated>2007-12-04 17:43:31</Updated> </Result> <Result> <Username>bar</Username> <Title>Dance Dance</Title> <Description></Description> <Tags></Tags> <RatingAverage>0</RatingAverage> <RatingCount>0</RatingCount> <Views>1</Views> <Created>2007-12-04 17:22:54</Created> <Updated>2007-12-04 17:22:54</Updated> </Result> </ResultSet>