Documentation

GetRandomResultTables

Retrieves the configuration information for the specified random results tables for the title, including all ItemId values and weights

Request Details

GetRandomResultTablesRequest
Request Properties
CatalogVersion String

Specifies the catalog version that should be used to retrieve the Random Result Tables. If unspecified, uses default/primary catalog.

TableIDs (required) List<String>

The unique identifier of the Random Result Table to use.

POST https://{{TitleID}}.playfabapi.com/Server/GetRandomResultTables
    Content-Type: application/json
    X-SecretKey: <developer_secret_key>
{
  "CatalogVersion": "1",
  "TableIDs": [
    "CommonElementCard",
    "UncommonElementCard",
    "RareElementCard"
  ]
}
        

Response Details

Note that if a specified Random Result Table contains no entries, or does not exist in the catalog, an InvalidDropTable error will be returned.

GetRandomResultTablesResult
Result Properties
Tables Dict<String, RandomResultTableListing>

array of random result tables currently available

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
  "code": 200,
  "status": "OK",
  "data": {
    "Tables": {
      "blah": {
        "CatalogVersion": "1",
        "TableId": "DropTable 1",
        "Nodes": [
          {
            "ResultItemType": "ItemId",
            "ResultItem": "Gold Crown 1",
            "Weight": 20
          },
          {
            "ResultItemType": "ItemId",
            "ResultItem": "Magic Sword 3",
            "Weight": 50
          },
          {
            "ResultItemType": "ItemId",
            "ResultItem": "Clear Shield 3",
            "Weight": 70
          }
        ]
      }
    }
  }
}

Authentication

SecretKey

Possible Error Codes

Name Code
CatalogNotConfigured 1218
InvalidDropTable 1201