Catalog

The ChillConnect Admin API Catalog module. Provides the means to retrieve and manipulate catalog items.

Get Catalog Versions

Get all catalog versions.

https://adminapi.chilliconnect.com/game/{token}/catalog/versions

Header

Field Type Description
Api-Token

String

The token of a valid API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

API version to call.

HTTP Status 200

Field Type Description
Response

JSON

A list of versions, with their version ID, package URL and date published.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

UnprocessableEntity

Invalid Request. One of more of the provided fields were not correctly formatted. The response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Get Catalog Version Diff

Get difference between requested and previous version

https://adminapi.chilliconnect.com/game/{token}/catalog/versions/diff/{version}

Header

Field Type Description
Api-Token

String

The token of a valid API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

API version to call.

HTTP Status 200

Field Type Description
VersionDiff

Object

  RequestedVersion

Object

Contains information on the requested version.

    Version

String

Version identifier.

    DatePublished

String

Date of the version being published (UTC). Format: ISO8601 e.g. 2016-01-12T11:08:23.

  PreviousVersion

Object

Contains information on the previous version to the one requested.

    Version

String

Version identifier.

    DatePublished

String

Date of the version being published (UTC). Format: ISO8601 e.g. 2016-01-12T11:08:23.

  Details

Array

Contains a list of elements keyed by item key. Each element contains new and original version of item properties.

    {Key}

Array

A variable field name containing the key of the item.

      Original

Array

Contains a list of the properties of the original item. Fields depend on the type of the item.

      New

Array

Contains a list of new/updated item properties of the original item. Fields depend on the type of the item.

  Summary

Array

Contains summary of the differences between two versions, grouped by the state (added, edited, unchanged and deleted).

    Added

Array

Contains a list of added item summaries.

      IsType

Boolean

Indicates whether the item is a type.

      IsCustom

Boolean

Indicates if the item is one of the custom types.

      Key

String

Key of the item.

      Type

String

Type of the item.

      TypeName

String

Human readable name of the type.

    Edited

Array

Contains a list of edited item summaries.

      IsType

Boolean

Indicates whether the item is a type.

      IsCustom

Boolean

Indicates if the item is one of the custom types.

      Key

String

Key of the item.

      Type

String

Type of the item.

      TypeName

String

Human readable name of the type.

    Unchanged

Array

Contains a list of unchanged item summaries.

      IsType

Boolean

Indicates whether the item is a type.

      IsCustom

Boolean

Indicates if the item is one of the custom types.

      Key

String

Key of the item.

      Type

String

Type of the item.

      TypeName

String

Human readable name of the type.

    Deleted

Array

Contains a list of deleted item summaries.

      IsType

Boolean

Indicates whether the item is a type.

      IsCustom

Boolean

Indicates if the item is one of the custom types.

      Key

String

Key of the item.

      Type

String

Type of the item.

      TypeName

String

Human readable name of the type.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

10111

CatalogVersionNotFound

Catalog Version does not exist.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Publish Catalog

Publish a new catalog version.

https://adminapi.chilliconnect.com/game/{token}/catalog/publish

Header

Field Type Description
Api-Token

String

The token of a valid API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

API version to call.

Body Parameter

Field Type Description
Commit optional

Boolean

A flag that if true, publishes the catalog. If false, shows the differences with the previous version. Defaults to false.

HTTP Status 200

Field Type Description
Difference with previous version

JSON

Provides a DiffSummary and DiffDetails from comparing the working copy with the last published version. DiffSummary lists the added, edited, deleted and unchanged items. DiffDetails provides more information on the changed items.

Catalog published

JSON

The new version details followed by the package URL.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

UnprocessableEntity

Invalid Request. One of more of the provided fields were not correctly formatted. The response body will contain specific error messages for each field.

10110

LiveOpsConflicts

Invalid Request. The requested action is in conflict with a LiveOps instance. The Conflicts property of the response body will contain specific information on which items are in conflict.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Import Catalog

Import a catalog of items into the economy. The body content-type must be multipart/form-data. Can also provide information about the differences between the imported catalog and the working copy.

https://adminapi.chilliconnect.com/game/{token}/catalog/import

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Content-Type

String

The body content type must be multipart/form-data.

Body Parameter

Field Type Description
ZipPackage

Zip File

The catalog zip file to upload.

Commit optional

Boolean

A flag that if true, publishes the catalog. If false, shows the differences with the previous version. Defaults to false.

HTTP Status 200

Field Type Description
Response

JSON

Provides a Success and Committed flags. Also returns the Imported, Diff and Conflicts data after comparing the imported catalog with the current one. Success indicates if there are any issues with the import. Committed indicates if the import is completed. Imported lists the new, updated, removed and unchanged items, while Diff provides more information on the changed items. Conflicts list the items in conflict with LiveOps instances.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

UnprocessableEntity

Invalid Request. One of more of the provided fields were not correctly formatted. The response body will contain specific error messages for each field.

1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Get Catalog Items

Get items from the catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/items

Header

Field Type Description
Api-Token

String

The token of a valid API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

API version to call.

URL Parameter

Field Type Description
Version optional

Integer

If not given the working copy set of items will be returned. Otherwise is a version as returned from the GetCatalogVersions endpoint, and will return items in that published version.

Offset optional

Integer

The number of items to skip before retrieving items.

Limit optional

Integer

The number of items to return (default/max is 20).

Keys optional

Array

Filter items by keys.

Note: to pass an array in a request the parameter is formatted as Keys[]=first.

KeyContains optional

String

Filter item keys with search term

Types optional

Array

Filter items by types.

Note: to pass an array in a request the parameter is formatted as Types[]=first.

Tags optional

Array

Filter items by tags.

Note: to pass an array in a request the parameter is formatted as Tags[]=first.

TagType optional

String

Values; ANY, ALL. When ALL an item will be included only if it has all of the Tags specified in the request. When ANY, any matched Tag will cause the item to be included.

HTTP Status 200

Field Type Description
Response

JSON

Version details followed by the list of retrieved catalog items. Items are paged with a default and max value of 20 items per page.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

10111

CatalogVersionNotFound

Catalog Version does not exist.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Currency

Add a Currency catalog item to the game's catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Type

String

Must be CURRENCY.

Name

String

The name of the currency.

Key

String

The key of the currency.

Tags optional

Array

The property tags given to the currency.

CustomData optional

JSON

The custom variables assigned to the currency.

Initial optional

Integer

The initial quantity allocation of a currency. Must be greater than or equal to 0.

Max optional

Integer

The max quantity allocation of a currency. Must be greater than or equal to 0.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1007

UnprocessableEntity

Invalid Request. One of more of the provided fields were not correctly formatted. The response body will contain specific error messages for each field.

1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Currency Conversion

Add a Currency Conversion catalog item to the game's catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Type

String

Must be CONVERSION.

Name

String

The name of the currency conversion.

Key

String

The key of the currency conversion.

Tags optional

Array

The property tags given to the currency conversion.

CustomData optional

JSON

The custom variables assigned to the currency conversion.

Rules

Array

An array of rules defining the conversion. Can have more than one rule per currency conversion. A Currency can be used more than once in a single Currency Conversion.

  CurrencyFromEconomyItemKey

String

The conversion from Currency.

  AmountFrom

Integer

The from amount.

  CurrencyToEconomyItemKey

String

The conversion to Currency.

  AmountTo

Integer

The to amount.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Inventory Item

Add an Inventory Item catalog item to the game's catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Type

String

Must be INVENTORYITEM.

Name

String

The name of the inventory item.

Key

String

The key of the inventory item.

Tags optional

Array

The property tags given to the inventory item.

CustomData optional

JSON

The custom variables assigned to the inventory item.

InitialAllocation optional

Integer

The initial quantity allocation of the inventory item. Must be greater than or equal to 0.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Virtual Purchase

Add a Virtual Purchase catalog item to the game's catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Type

String

Must be VIRTUALPURCHASE.

Name

String

The name of the virtual purchase.

Key

String

The key of the virtual purchase.

Tags optional

Array

The property tags given to the virtual purchase.

CustomData optional

JSON

The custom variables assigned to the virtual purchase.

Costs optional

Array

The costs for making a virtual purchase. Can have more than one cost per purchase. An economy item can be used more than once.

  EconomyItemKey

String

The Key of the item used in the exchange.

  Amount

Integer

The amount of items issued as a reward.

Rewards

Array

The rewards for making a virtual purchase. Can have more than one reward per purchase. An economy item can be used more than once.

  EconomyItemKey

String

The Key of the item used in the exchange.

  Amount

Integer

The amount of items issued as a reward.

OneTimePurchase

Boolean

Flag determining if the virtual purchase is a one-time event.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Real Money Purchase

Add a Real Money Purchase catalog item to the game's catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Type

String

Must be MONEYPURCHASE.

Name

String

The name of the real money purchase.

Key

String

The key of the real money purchase.

Tags optional

Array

The property tags given to the real money purchase.

CustomData optional

JSON

The custom variables assigned to the real money purchase.

IosID optional

String

iOS account ID used when making a real money purchase. At least one store ID is required.

GoogleID optional

String

Google account ID used when making a real money purchase. At least one store ID is required.

AmazonID optional

String

Amazon account ID used when making a real money purchase. At least one store ID is required.

Rewards

Array

The rewards for making a real money purchase. Can have more than one reward per purchase. An economy item can be used more than once.

  EconomyItemKey

String

The Key of the item used in the exchange.

  Amount

Integer

The amount of items issued as a reward.

OneTimePurchase

Boolean

Flag determining if the real money purchase is a one-time event.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Metadata

Add a Metadata item to the game's catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Type

String

Must be METADATA.

Name

String

The name of the metadata.

Key

String

The key of the metadata.

Tags optional

Array

The property tags given to the metadata.

CustomData optional

JSON

The custom variables assigned to the metadata.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1007

UnprocessableEntity

Invalid Request. One of more of the provided fields were not correctly formatted. The response body will contain specific error messages for each field.

1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Zip Package

Add a Zip Package to a game's catalog.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Content-Type

String

Must be multipart/form-data.

Body Parameter

Field Type Description
Type

String

Must be ZIPPACKAGE

Name

String

The name of the zip package.

Key

String

The key of the zip package.

Tags optional

Array

The property tags given to the zip package.

Note: to pass an array in a request the parameter is formatted as Tags[]=first.

CustomData optional

JSON

The custom variables assigned to the zip package.

ZipPackage

Zip File

The zip file to upload.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1004

InvalidContentType

Content-type must be multipart/form-data.

1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Add Custom Type Item

Add an item from one of the defined custom types.

https://adminapi.chilliconnect.com/game/{token}/catalog/item

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Type

String

Must be the key of the custom type.

Name

String

The name of the custom type item.

Key

String

The key of the custom type item.

Tags optional

Array

The property tags given to the custom type item.

CustomData optional

JSON

The custom variables assigned to the custom type item.

Data

JSON

The attributes of the defined custom item type.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 409

Code Title Errors
10107

CatalogItemExistsAsOverride

Key exists in overrides.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

10101

CatalogItemExists

Key exists in overrides.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Currency

Edit a Currency catalog item.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/CURRENCY/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Name

String

The name of the currency.

Tags optional

Array

The property tags given to the currency.

CustomData optional

JSON

The custom variables assigned to the currency.

Initial optional

Integer

The initial quantity allocation of a currency. Must be greater than or equal to 0.

Max optional

Integer

The max quantity allocation of a currency. Must be greater than or equal to 0.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Currency Conversion

Edit a Currency Conversion catalog item.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/CONVERSION/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Name

String

The name of the currency conversion.

Tags optional

Array

The property tags given to the currency conversion.

CustomData optional

JSON

The custom variables assigned to the currency conversion.

Rules

Array

An array of rules defining the conversion. Can have more than one rule per currency conversion. A Currency can be used more than once in a single Currency Conversion.

  CurrencyFromEconomyItemKey

String

The conversion from Currency.

  AmountFrom

Integer

The from amount.

  CurrencyToEconomyItemKey

String

The conversion to Currency.

  AmountTo

Integer

The to amount.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Inventory Item

Edit an Inventory Item catalog item.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/INVENTORYITEM/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Name

String

The name of the inventory item.

Tags optional

Array

The property tags given to the inventory item.

CustomData optional

JSON

The custom variables assigned to the inventory item.

InitialAllocation optional

Integer

The initial quantity allocation of the inventory item. Must be greater than or equal to 0.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Virtual Purchase

Edit a Virtual Purchase catalog item.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/VIRTUALPURCHASE/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Name

String

The name of the virtual purchase.

Tags optional

Array

The property tags given to the virtual purchase.

CustomData optional

JSON

The custom variables assigned to the virtual purchase.

Costs optional

Array

The costs for making a virtual purchase. Can have more than one cost per purchase. An economy item can be used more than once.

  EconomyItemKey

String

The Key of the item used in the exchange.

  Amount

Integer

The amount of items issued as a reward.

Rewards

Array

The rewards for making a virtual purchase. Can have more than one reward per purchase. An economy item can be used more than once.

  EconomyItemKey

String

The Key of the item used in the exchange.

  Amount

Integer

The amount of items issued as a reward.

OneTimePurchase

Boolean

Flag determining if the virtual purchase is a one-time event.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Real Money Purchase

Edit a Real Money Purchase catalog item.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/MONEYPURCHASE/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Name

String

The name of the real money purchase.

Tags optional

Array

The property tags given to the real money purchase.

CustomData optional

JSON

The custom variables assigned to the real money purchase.

IosID optional

String

iOS account ID used when making a real money purchase. At least one store ID is required.

GoogleID optional

String

Google account ID used when making a real money purchase. At least one store ID is required.

AmazonID optional

String

Amazon account ID used when making a real money purchase. At least one store ID is required.

Rewards

Array

The rewards for making a real money purchase. Can have more than one reward per purchase. An economy item can be used more than once.

  EconomyItemKey

String

The Key of the item used in the exchange.

  Amount

Integer

The amount of items issued as a reward.

OneTimePurchase

Boolean

Flag determining if the real money purchase is a one-time event.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Metadata

Edit a Metadata catalog item.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/METADATA/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Name

String

The name of the metadata.

Tags optional

Array

The property tags given to the metadata.

CustomData optional

JSON

The custom variables assigned to the metadata.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Zip Package

Edit a Zip Package catalog item.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/ZIPPACKAGE/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Content-Type

String

Must be multipart/form-data.

Body Parameter

Field Type Description
Name

String

The name of the zip package.

Tags optional

Array

The property tags given to the zip package.

Note: to pass an array in a request the parameter is formatted as Tags[]=first.

CustomData optional

JSON

The custom variables assigned to the zip package.

ZipPackage

Zip File

The zip file to upload.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1004

InvalidContentType

Content-type must be multipart/form-data.

1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Edit Custom Type Item

Edit an item from one of the defined custom types. Note that {type} parameter in the URL must be replaced with the key of the custom type.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/{type}/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

Body Parameter

Field Type Description
Name

String

The name of the custom type item.

Tags optional

Array

The property tags given to the custom type item.

CustomData optional

JSON

The custom variables assigned to the custom type item.

Data

JSON

The attributes of the defined custom item type.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

InvalidRequest

Invalid Request. One of more of the provided fields were not correctly formatted. The Errors property of the response body will contain specific error messages for each field.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Delete Catalog Item

Delete a catalog item from the economy.

https://adminapi.chilliconnect.com/game/{token}/catalog/item/{type}/{key}

Header

Field Type Description
Api-Token

String

The valid token of the API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

The version of the API to call.

URL Parameter

Field Type Description
Type

String

The type of catalog item to delete.

Key

String

The key of the catalog item to delete.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

10103

CatalogItemNotFound

Catalog Item Not Found.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 422

Code Title Errors
1007

UnprocessableEntity

Invalid Request. One of more of the provided fields were not correctly formatted. The response body will contain specific error messages for each field.

10104

CatalogItemInUse

Catalog item cannot be deleted as it is referenced by other items.

10108

CatalogItemInUseInOverride

Catalog item cannot be deleted as it is referenced by other items.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Metrics

The ChillConnect Admin API Metrics module. Provides the means to retrieve information surrounding metrics and analytics.

Get Exports

Get the Bar-Delimited Value formatted data exports that we hold in our warehouse for a certain Date.

https://adminapi.chilliconnect.com/game/{token}/analytics/exports

Header

Field Type Description
Api-Token

String

The token of a valid API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

API version to call.

URL Parameter

Field Type Description
Date optional

String

The requested date of the Exports. Defaults to yesterdays date. Format: YYYY-MM-DD.

HTTP Status 200

Field Type Description
Exports

Array

A list of Data Exports for the requested Date.

  {Export}

Array

Name of the Export type. Can be one of Events, Sessions, SessionSegments, Purchases, Installs, KPIs, EventTypes, EventTypeParams. Note if there is no data for the Export type it will be absent from this list.

    Url

String

URL of the file, can be used to download the Metrics Export. Please note these links expire within an hour of being generated so you will need to call this endpoint again to regenerate the URLs with a new Expiry.

    Filename

String

The name of the file that is being referenced.

    PartNumber

Integer

The files are split into Parts. This variable denotes which part number this file is.

    FileSize

Integer

The size of the file part in Bytes.

Date

String

The Date of the returned Data Export. Format: YYYY-MM-DD.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.

Get Definitions

Definitions detailing the data contents of each file returned in the GetExports endpoint.

https://adminapi.chilliconnect.com/game/{token}/analytics/definitions/exports

Header

Field Type Description
Api-Token

String

The token of a valid API user.

Api-Secret

String

The valid password of the API user.

Api-Version

String

API version to call.

HTTP Status 200

Field Type Description
ExportDefinitions

Array

A list detailing each of columns contained in the Exports.

  {Export}

Array

Definition of the data contained in each Export.

    Name

String

Reference name of the column for use of the client accessing the Export.

    Type

String

Type of data contained within the column. Although always a string in the Export files itself, can be safely typecast to one of the following: String, Int, Date, DateTime, Decimal.

    Description

String

Description of what the data in that particular column is.

    Example

String

An Example of what may be contained in that column.

HTTP Status 400

Code Title Errors
1007

BadRequest

Invalid Request. Required headers: Api-Token, Api-Secret, Api-Version.

HTTP Status 401

Code Title Errors
1005

Unauthorized

Invalid credentials.

HTTP Status 404

Code Title Errors
1007

AppNotFound

The selected Application either doesn't exist or the API User doesn't have permissions to access it.

HTTP Status 500

Code Title Errors
1

Unexpected

Unexpected Error. An unexpected, fatal error has occurred.