🎒Inventory

Get inventory item

GET /v3/inventory

Headers

Name	Value
X-Api-Key*	API Key
Authorization*	Bearer <token>

Response

200

{
    "status": "success",
    "messages": "Inventory retrieved from database",
    "data": [
        {
            "inventory_id": "01J69MZN65585AWEHCMG175EPW",
            "game_internal_id": "life_30_minutes",
            "komo_item_name": "Life 30 Minutes"
        },
        {
            "inventory_id": "01J69MZN65585AWEHCMG175EPY",
            "game_internal_id": "life_30_minutes",
            "komo_item_name": "Life 30 Minutes"
        },
        {
            "inventory_id": "01J69MZN65585AWEHCMG175EPZ",
            "game_internal_id": "life_30_minutes",
            "komo_item_name": "Life 30 Minutes"
        },
        {
            "inventory_id": "01J69MZN65585AWEHCMG175EQ0",
            "game_internal_id": "life_30_minutes",
            "komo_item_name": "Life 30 Minutes"
        }
    ]
}

Remove item from inventory

POST /v3/inventory/remove

Headers

Name	Value
X-Api-Key*	API Key
Authorization*	Bearer <token>

Body

Name	Type	Description
inventory_id*	string	Inventory ID

Response

200

{
    "status": "success",
    "messages": "Inventory removed"
}

400 (invalid ID)

{
    "status": "error",
    "messages": {
        "inventory_id": "The selected inventory id is invalid."
    }
}

400 (invalid owner)

{
    "status": "error",
    "messages": {
        "invalidOwner": "Invalid inventory owner"
    }
}

400 (invalid game)

{
    "status": "error",
    "messages": {
        "invalidGame": "This game is not authorized to remove this item"
    }
}

Inject mystery box ticket

POST /v3/inventory/inject/mystery-box-ticket

Headers

Name	Value
X-API-Key*	API Key
Authorization*	Bearer <token>

Body

Name	Type	Description
qty*	string	amount of ticket injected

Response

200

{
    "status": "success",
    "messages": "Mystery box ticket added"
}

Inject in-game items

POST /v3/inventory/inject/in-game-item

Before injecting to inventory, make sure the item is available on database alphagames game_items table

Headers

Name	Value
X-Api-Key*	API Key
Authorization*	Bearer <token>

Body

Name	Type	Description
item_list*	string	Stringified json of game_internal_id and qty. Example below

Example Payload

{
    "item_list": "[{\"game_internal_id\":\"life_30_minutes\",\"qty\":2},{\"game_internal_id\":\"other_internal_id\",\"qty\":3}]"
}

Response

200

{
    "status": "success",
    "messages": "Item injected successfully"
}

400

{
    "status": "error",
    "messages": {
        "itemNotExists": "Item with game_internal_id other_internal_id is not exist"
    }
}

Inject alfa voucher (from reward pool)

POST /v3/inventory/inject/voucher

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
name	string	Name of the user
age	number	Age of the user

Response

200

{
    "status": "success",
    "messages": "All voucher injected successfully"
}

400 (voucher stock below margin)

{
    "status": "error",
    "messages": {
        "stockBelowMargin": "Voucher stock for 25000 is below allowed margin."
    }
}

400 (invalid json data)

// qty is not integer or below 1
{
    "status": "error",
    "messages": {
        "invalidQty": "Invalid qty"
    }
}

// voucher_value is not available on database
{
    "status": "error",
    "messages": {
        "invalidVoucherValue": "Invalid voucher_value"
    }
}