Server API

Add Asset to Player Inventory

POST

https://api.lootlocker.io/server/player/{player_id}/inventory

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.lootlocker.io/server/player/363/inventory' \
--header 'LL-Version: 2021-03-01' \
--header 'Content-Type: application/json' \
--header 'x-auth-token;' \
--data-raw '{
    "asset_id": 64,
    "asset_variation_id": null
}'

Response Example

{
    "items": [
        {
            "id": 1,
            "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
            "ulid": "01J8J4FJG869W5Q19FSDT8D3AC",
            "name": "string",
            "active": true,
            "purchasable": true,
            "price": 0,
            "sales_price": 1,
            "display_price": "string",
            "context": "string",
            "context_id": 1,
            "character_classes": [
                1
            ],
            "unlocks_context": "string",
            "detachable": true,
            "updated": "string",
            "marked_new": "string",
            "default_variation_id": 1,
            "default_loadouts": {
                "<user supplied loadout name>": true
            },
            "description": "string",
            "links": [
                {
                    "<user supplied simple name>": "string"
                }
            ],
            "storage": [
                {
                    "key": "string",
                    "value": "string"
                }
            ],
            "rarity": {
                "name": "string",
                "short_name": "string",
                "color": "string"
            },
            "popular": true,
            "popularity_score": 1,
            "package_contents": [
                {
                    "asset": {}
                }
            ],
            "unique_instance": true,
            "external_identifiers": {
                "psn": {
                    "entitlement_id": "string",
                    "sku_id": "string",
                    "product_id": "string"
                },
                "apple_app_store": {
                    "product_id": "string"
                },
                "google_play": {
                    "product_id": "string"
                }
            },
            "rental_options": [
                {
                    "id": 0,
                    "name": "string",
                    "duration": 0,
                    "price": 0,
                    "sales_price": 0,
                    "links": [
                        {
                            "<user supplied simple name>": "string"
                        }
                    ]
                }
            ],
            "filters": [
                {
                    "value": "string",
                    "name": "string"
                }
            ],
            "files": [
                {
                    "id": 1,
                    "name": "string",
                    "duration": 1,
                    "price": 1,
                    "sales_price": 1,
                    "links": [
                        {
                            "<user supplied simple name>": "string"
                        }
                    ]
                }
            ],
            "data_entities": [
                "string"
            ],
            "hero_equip_exceptions": [
                {
                    "can_equip": true,
                    "hero_id": 0,
                    "hero_name": "string"
                }
            ],
            "asset_candidate": 1,
            "drop_table_max_picks": 1,
            "variations": [
                {
                    "id": 1,
                    "name": "string",
                    "primary_color": "string",
                    "secondary_color": "string",
                    "links": [
                        {
                            "<user supplied simple name>": "string"
                        }
                    ]
                }
            ],
            "featured": true,
            "context_locked": true,
            "initially_purchasable": true
        }
    ]
}

Request

Authorization

API Key

Add parameter in header

x-auth-token

Example:

x-auth-token: ********************

Path Params

player_id

string

required

Example:

363

Header Params

LL-Version

string

required

Example:

2021-03-01

Body Params application/json

asset_id

integer

required

asset_variation_id

null

required

Examples

Responses

🟢200OK

application/json

Body

items

array[object (Asset v1) {38}]

required

integer <uint64> | null

required

>= 1

uuid

string <uuid> | null

required

ulid

string | null

required

Example:

01J8J4FJG869W5Q19FSDT8D3AC

name

string | null

required

active

boolean | null

required

purchasable

boolean | null

required

price

integer <uint64> | null

deprecated

Price for the old economy system

sales_price

integer <uint64> | null

deprecated

Sales price for the old economy system

>= 1

display_price

string | null

deprecated

Display price for the old economy system

context

string | null

required

Name of the context this asset belongs to

context_id

integer <uint64> | null

required

ID of the context this asset belongs to

>= 1

character_classes

array[integer <uint64> | null] | null

required

unlocks_context

string

required

Name of the context that will be unlocked via ownership of this asset.

detachable

boolean | null

required

Can the asset be detached from a players loadout?

updated

string | null

required

When this asset was last updated

marked_new

string | null

required

Used to allow game UIs to show a new badge on items even if they aren't technically new

default_variation_id

integer <uint64> | null

deprecated

>= 1

default_loadouts

object | null

required

A list of names of character names with a boolean value for if the asset is in said characters default loadout (dynamic keys)

description

string | null

required

Free text description of the asset

links

array [object {1}]

required

An object of external references such as images (dynamic keys)

storage

array [object {2}] | null

required

A key/value storage

rarity

object | null

required

popular

boolean | null

deprecated

Is this asset popular with players?

popularity_score

integer <uint64> | null

deprecated

The raw number used to calculate if the asset is popular

>= 1

package_contents

array [object {1}] | null

deprecated

unique_instance

boolean | null

required

If true, the player can only own one of this asset

external_identifiers

object | null

required

rental_options

array [object {6}]

required

filters

array [object {2}] | null

required

files

array [object {6}] | null

required

data_entities

array[string | null] | null

required

hero_equip_exceptions

array [object {3}] | null

required

asset_candidate

integer <uint64>

required

Set to the ID of the asset candidate if this is an asset derived from an asset candidate

>= 1

drop_table_max_picks

integer <uint64>

required

>= 1

variations

array [object {5}] | null

required

featured

boolean | null

required

context_locked

boolean | null

required

initially_purchasable

boolean | null

required

Alter Player Inventory

List Universal Assets