Player Item Management - Get Random Result Tables

  • Reference
Service:
Server
API Version:
240412

NOTE: This is a Legacy Economy API, and is in bugfix-only mode. All new Economy features are being developed only for version 2. Retrieves the configuration information for the specified random results tables for the title, including all ItemId values and weights

POST https://titleId.playfabapi.com/Server/GetRandomResultTables

Request Header

Name Required Type Description
X-SecretKey True

string

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Request Body

Name Required Type Description
TableIDs True

string[]

The unique identifier of the Random Result Table to use.
CatalogVersion

string

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

Responses

Name Type Description
200 OK

GetRandomResultTablesResult

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

ApiErrorWrapper

This is the outer wrapper for all responses with errors

Security

X-SecretKey

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Type: apiKey
In: header

Definitions

Name Description
ApiErrorWrapper

The basic wrapper around every failed API response
GetRandomResultTablesRequest
GetRandomResultTablesResult

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

ApiErrorWrapper

The basic wrapper around every failed API response

Name Type Description
code

integer

Numerical HTTP code
error

string

Playfab error code
errorCode

integer

Numerical PlayFab error code
errorDetails

object

Detailed description of individual issues with the request object
errorMessage

string

Description for the PlayFab errorCode
status

string

String HTTP code

GetRandomResultTablesRequest

Name Type Description
CatalogVersion

string

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

string[]

The unique identifier of the Random Result Table to use.

GetRandomResultTablesResult

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

Name Type Description
Tables

RandomResultTableListing

array of random result tables currently available

RandomResultTableListing

Name Type Description
CatalogVersion

string

Catalog version this table is associated with
Nodes

ResultTableNode[]

Child nodes that indicate what kind of drop table item this actually is.
TableId

string

Unique name for this drop table

ResultTableNode

Name Type Description
ResultItem

string

Either an ItemId, or the TableId of another random result table
ResultItemType

ResultTableNodeType

Whether this entry in the table is an item or a link to another table
Weight

number

How likely this is to be rolled - larger numbers add more weight

ResultTableNodeType

Name Type Description
ItemId

string

TableId

string

Error Codes

Name Code
CatalogNotConfigured 1218
InvalidDropTable 1201