Overview
Updates pricing, metadata, or configuration for an existing store item.
Client
Require permission rules storeInventory.setStoreItemInformation.selfEnable. See PermissionRules
HTTP
POST /api/rJson/storeInventory/client/setStoreItemInformation
Request Headers
| Name | Required | Description |
|---|---|---|
| Auth-Token | true | A token used to authenticate the user. It is issued after successful login from the client type authenticate (e.g., loginByAccount, loginWithCustomId, etc.) or when an admin logs in via the GearN Dashboard. This token identifies the request sender and determines their access level. |
| Secret-Key | true | The SecretKey in SecretInfo with role must is Player. |
| Game-Id | Optional if the gameId in the SecretInfo use in headers Secret-Key has assign a valid value, if not, let unique identifier of the game this request is targeting. | |
| Content-Type | true | application/json |
Request Body
| Code | Type | Required | Description |
|---|---|---|---|
| storeId | string | true | Unique identifier of the store item. (10 - 32 characters) |
| storeItemType | number int | StoreItemType parameter. (from 1 to 2) | |
| storeDatas | StoreDataParam[] | StoreDatas parameter. (0 - 32 elements) See StoreDataParam | |
| storeItems | StoreItemParam[] | StoreItems parameter. (0 - 32 elements) See StoreItemParam | |
| storeCurrencies | CurrencyParam[] | StoreCurrencies parameter. (0 - 32 elements) See CurrencyParam | |
| priceCurrencies | CurrencyParam[] | PriceCurrencies parameter. (0 - 32 elements) See CurrencyParam | |
| inAppPurchase | InAppPurchaseParam | InAppPurchase parameter. See InAppPurchaseParam | |
| displayName | string | Public-facing name of the store item. | |
| avatar | AvatarParam | Visual representation or image URL of the store item. See AvatarParam | |
| tags | TagParam[] | Tags parameter. (0 - 32 elements) See TagParam |
Server
Require permission rules storeInventory.setStoreItemInformation.serverSelfEnable. See PermissionRules
HTTP
POST /api/rJson/storeInventory/server/setStoreItemInformation
Request Headers
| Name | Required | Description |
|---|---|---|
| Secret-Key | true | The SecretKey in SecretInfo with role must is Server. |
| Game-Id | Optional if the gameId in the SecretInfo use in headers Secret-Key has assign a valid value, if not, let unique identifier of the game this request is targeting. | |
| Content-Type | true | application/json |
Request Body
| Code | Type | Required | Description |
|---|---|---|---|
| storeId | string | true | Unique identifier of the store item. (10 - 32 characters) |
| storeItemType | number int | StoreItemType parameter. (from 1 to 2) | |
| storeDatas | StoreDataParam[] | StoreDatas parameter. (0 - 32 elements) See StoreDataParam | |
| storeItems | StoreItemParam[] | StoreItems parameter. (0 - 32 elements) See StoreItemParam | |
| storeCurrencies | CurrencyParam[] | StoreCurrencies parameter. (0 - 32 elements) See CurrencyParam | |
| priceCurrencies | CurrencyParam[] | PriceCurrencies parameter. (0 - 32 elements) See CurrencyParam | |
| inAppPurchase | InAppPurchaseParam | InAppPurchase parameter. See InAppPurchaseParam | |
| displayName | string | Public-facing name of the store item. | |
| avatar | AvatarParam | Visual representation or image URL of the store item. See AvatarParam | |
| tags | TagParam[] | Tags parameter. (0 - 32 elements) See TagParam |
Admin
Require permission rules storeInventory.setStoreItemInformation.adminSelfEnable. See PermissionRules
HTTP
POST /api/rJson/storeInventory/admin/setStoreItemInformation
Request Headers
| Name | Required | Description |
|---|---|---|
| Secret-Key | true | The SecretKey in SecretInfo with role must is Admin. |
| Game-Id | Optional if the gameId in the SecretInfo use in headers Secret-Key has assign a valid value, if not, let unique identifier of the game this request is targeting. | |
| Content-Type | true | application/json |
Request Body
| Code | Type | Required | Description |
|---|---|---|---|
| storeId | string | true | Unique identifier of the store item. (10 - 32 characters) |
| storeItemType | number int | StoreItemType parameter. (from 1 to 2) | |
| storeDatas | StoreDataParam[] | StoreDatas parameter. (0 - 32 elements) See StoreDataParam | |
| storeItems | StoreItemParam[] | StoreItems parameter. (0 - 32 elements) See StoreItemParam | |
| storeCurrencies | CurrencyParam[] | StoreCurrencies parameter. (0 - 32 elements) See CurrencyParam | |
| priceCurrencies | CurrencyParam[] | PriceCurrencies parameter. (0 - 32 elements) See CurrencyParam | |
| inAppPurchase | InAppPurchaseParam | InAppPurchase parameter. See InAppPurchaseParam | |
| displayName | string | Public-facing name of the store item. | |
| avatar | AvatarParam | Visual representation or image URL of the store item. See AvatarParam | |
| tags | TagParam[] | Tags parameter. (0 - 32 elements) See TagParam |
Response Body
200 Ok
| Code | Type | Required | Description |
|---|---|---|---|
| returnCode | ReturnCode | true | Additional metadata that can be attached to any request. Especially useful when working with advanced features such as EventCallbackScript. See ReturnCode |
| debugMessage | string | A developer-oriented message that provides additional context useful for debugging and internal logging. This field is not intended for end-users and may include stack traces, validation failures, or internal error diagnostics. | |
| invalidRequestParameters | InvalidMember[] | Just had data when the returnCode is InvalidRequestParameters.A list of members that failed validation or could not be processed during the request. Each entry typically includes identifying information and an error reason. This is useful for partial success scenarios where some members are accepted and others are rejected. See InvalidMember | |
| parameters | ResponseData | Just had data when the returnCode is Ok. A dynamic set of key-value pairs included in the response to provide additional context or metadata. These parameters may vary depending on the operation and typically contain optional fields such as timestamps, identifiers, or computed values relevant to the result. See ResponseData |
ReturnCode
| Name | Code | Description |
|---|---|---|
| SecretInvalid | -10 | Secret token is invalid (removed, expired or does not contains). |
| MaxSizeRequestReject | -9 | Request rejected due to exceeding maximum allowed size. |
| MaxRequestReject | -8 | Request rejected because the number of requests has exceeded the allowed limit per user or IP or exceeds the total number of pending requests the server is waiting to process.. |
| MaxCCUReject | -7 | Connection rejected due to exceeding the allowed CCU (Concurrent Users). |
| OperationNotAuthorized | -6 | You are not authorized to perform this operation. Possibly due to missing or invalid token, or insufficient permissions. |
| InvalidRequestParameters | -5 | Request parameters are invalid or missing. |
| OperationInvalid | -4 | The requested operation is invalid or not supported. |
| InternalServerError | -3 | Internal server error. Could be due to an unhandled exception or logic failure. |
| OperationNotAllow | -2 | This operation is not allowed in the current context. |
| OperationTimeout | -1 | The operation timed out. No response received within the expected time. |
| UnknownError | 0 | An unknown error occurred. The cause could not be determined. |
| Ok | 1 | Success. The operation completed successfully and returned a valid result. |
ResponseData
| Code | Type | Required | Description |
|---|---|---|---|
| errorCode | ErrorCode | A string that represents the status of the operation. It indicates whether the request was successful or failed due to a specific error condition. See ErrorCode | |
| infoResponseParameters | InfoResponseParameters | true | InfoResponseParameters field in StoreInventoryResponseData. See InfoResponseParameters |
StoreDataParam
Contains structured data associated with a store item.
| Code | Type | Required | Description |
|---|---|---|---|
| key | string | true | Key field in StoreDataParam. (2 - 32 characters) |
| value | any | true | Value field in StoreDataParam. |
StoreItemParam
Metadata and configuration used when creating or updating a store item.
| Code | Type | Required | Description |
|---|---|---|---|
| catalogId | string | true | CatalogId field in StoreItemParam. (2 - 32 characters) |
| classId | string | true | ClassId field in StoreItemParam. (2 - 32 characters) |
| amount | number | true | The quantity or count related to the item operation. |
CurrencyParam
Defines a virtual currency and its corresponding amount.
| Code | Type | Required | Description |
|---|---|---|---|
| key | string | true | Key field in CurrencyParam. (2 - 32 characters) |
| value | number | true | Value field in CurrencyParam. |
InAppPurchaseParam
Represents an in-app purchase transaction with its metadata.
| Code | Type | Required | Description |
|---|---|---|---|
| facebookStoreId | string | FacebookStoreId field in InAppPurchaseParam. (1 - 128 characters) | |
| googlePlayStoreId | string | GooglePlayStoreId field in InAppPurchaseParam. (1 - 128 characters) | |
| appleAppStoreId | string | AppleAppStoreId field in InAppPurchaseParam. (1 - 128 characters) | |
| analyticsPrice | number | AnalyticsPrice field in InAppPurchaseParam. |
AvatarParam
Represents avatar configuration for store items.
| Code | Type | Required | Description |
|---|---|---|---|
| type | number int | true | Type field in AvatarParam. |
| value | string | true | Value field in AvatarParam. (1 - 128 characters) |
TagParam
Represents a tag or label used to classify a store item.
| Code | Type | Required | Description |
|---|---|---|---|
| key | string | true | Key field in TagParam. (2 - 32 characters) |
| value | string | true | Value field in TagParam. (2 - 32 characters) |
InfoResponseParameters
Optional fields included in store item responses.
| Code | Type | Required | Description |
|---|---|---|---|
| storeItems | StoreInventoryItem[] | StoreItems field in InfoResponseParameters. See StoreInventoryItem | |
| storeItemType | number | StoreItemType field in InfoResponseParameters. | |
| storeCurrencies | PriceCurrencyItem[] | StoreCurrencies field in InfoResponseParameters. See PriceCurrencyItem | |
| priceCurrencies | PriceCurrencyItem[] | PriceCurrencies field in InfoResponseParameters. See PriceCurrencyItem | |
| inAppPurchase | InAppPurchaseItem | InAppPurchase field in InfoResponseParameters. See InAppPurchaseItem | |
| removeStatus | GenericModels.RemoveStatusItem | RemoveStatus field in InfoResponseParameters. See GenericModels.RemoveStatusItem | |
| displayName | string | Display name shown to users for this store item. | |
| avatar | GenericModels.AvatarItem | Visual image or icon associated with the store item. See GenericModels.AvatarItem | |
| tsCreate | number | TsCreate field in InfoResponseParameters. | |
| tags | GenericModels.TagItem[] | Tags field in InfoResponseParameters. See GenericModels.TagItem | |
| storeDatas | GenericModels.DataItem[] | StoreDatas field in InfoResponseParameters. See GenericModels.DataItem |
StoreInventoryItem
Metadata and state information for a single store item.
| Code | Type | Required | Description |
|---|---|---|---|
| catalogId | string | true | CatalogId field in StoreInventoryItem. |
| classId | string | true | ClassId field in StoreInventoryItem. |
| amount | number | true | The quantity or count related to the item operation. |
PriceCurrencyItem
Details a price definition using a virtual currency.
| Code | Type | Required | Description |
|---|---|---|---|
| key | string | true | Key field in PriceCurrencyItem. |
| value | number | true | Value field in PriceCurrencyItem. |
InAppPurchaseItem
Describes an individual in-app purchase item configuration.
| Code | Type | Required | Description |
|---|---|---|---|
| facebookStoreId | string | true | FacebookStoreId field in InAppPurchaseItem. |
| appleAppStoreId | string | true | AppleAppStoreId field in InAppPurchaseItem. |
| googlePlayStoreId | string | true | GooglePlayStoreId field in InAppPurchaseItem. |
| analyticsPrice | number | true | AnalyticsPrice field in InAppPurchaseItem. |
Generic.RemoveStatusItem
Represents the removal state and related metadata for an entity.
| Code | Type | Required | Description |
|---|---|---|---|
| tsRemove | number | true | TsRemove field in RemoveStatusItem. |
| reason | string | Text explaining why the ban or action was applied. |
Generic.AvatarItem
Represents avatar-related metadata such as image, icon, and background colors.
| Code | Type | Required | Description |
|---|---|---|---|
| type | number | true | Type field in AvatarItem. |
| value | string | true | Value assigned to the specified key. |
Generic.TagItem
Represents a tag or category label used for filtering or grouping entities.
| Code | Type | Required | Description |
|---|---|---|---|
| key | string | true | Key used in a structured data pair. |
| value | string | true | Value assigned to the specified key. |
Generic.DataItem
Represents a structured key-value data pair stored in a player or group profile.
| Code | Type | Required | Description |
|---|---|---|---|
| key | string | true | Key used in a structured data pair. |
| value | any | true | Value assigned to the specified key. |
ErrorCode
| Name | Code |
|---|---|
| Ok | 1 |
| StoreItemNotFound | 30 |
InvalidMember
| Code | Type | Description |
|---|---|---|
| code | string | The parameterCode invalid. |
| invalidMemberType | InvalidMemberType | The invalid member type of this parameterCode. See InvalidMemberType |
InvalidMemberType
| Name | Code | Description |
|---|---|---|
| UnknownError | 1 | An unspecified or unexpected error has occurred. |
| DataRequired | 2 | A required data field is missing or not provided. |
| TypeInvalid | 3 | The data type provided does not match the expected type. |
| StringNull | 4 | A string value is null or has not been assigned. |
| StringMinLength | 5 | The string value is shorter than the minimum required length. |
| StringMaxLength | 6 | The string value exceeds the maximum allowed length. |
| NumberMinValue | 7 | The numeric value is less than the minimum allowed value. |
| NumberMaxValue | 8 | The numeric value exceeds the maximum allowed value. |
| NumberMustInt | 9 | The numeric value must be an integer but is not. |
| GNHashtableNull | 10 | The hashtable object is null or not provided. |
| GNHashtableMinLength | 11 | The hashtable contains fewer entries than the minimum required. |
| GNHashtableMaxLength | 12 | The hashtable contains more entries than the maximum allowed. |
| GNArrayNull | 13 | The array object is null or not provided. |
| GNArrayMinLength | 14 | The array contains fewer elements than the minimum required. |
| GNArrayMaxLength | 15 | The array contains more elements than the maximum allowed. |