Inventory

The Inventory API provides a comprehensive set of endpoints to interact with inventories.

Retrieve an inventory

get

Path parameters

ckeystringRequired

Responses

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

default

application/json

get

/v1/community/{ckey}/inventory

HTTPcURLJavaScriptPython

GET /v1/community/{ckey}/inventory HTTP/1.1
Accept: */*

{
  "code": 10002,
  "message": "generic_client_error"
}

Return the slots of an inventory

get

Path parameters

ckeystringRequired

Query parameters

userIdstringRequired

Responses

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

default

application/json

get

/v1/community/{ckey}/inventory/slots

HTTPcURLJavaScriptPython

GET /v1/community/{ckey}/inventory/slots?userId=text HTTP/1.1
Accept: */*

{
  "code": 10002,
  "message": "generic_client_error"
}

Return list of items of a slot

get

Path parameters

ckeystringRequired

slotIdstringRequired

Query parameters

pagenumberOptional

limitnumberOptional

onlyOwnedstringRequired

Responses

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

default

application/json

get

/v1/community/{ckey}/inventory/slots/{slotId}/items

HTTPcURLJavaScriptPython

GET /v1/community/{ckey}/inventory/slots/{slotId}/items?onlyOwned=text HTTP/1.1
Accept: */*

{
  "code": 10002,
  "message": "generic_client_error"
}

Return item

get

Path parameters

ckeystringRequired

itemIdstringRequired

Responses

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

default

application/json

get

/v1/community/{ckey}/inventory/items/{itemId}

HTTPcURLJavaScriptPython

GET /v1/community/{ckey}/inventory/items/{itemId} HTTP/1.1
Accept: */*

{
  "code": 10002,
  "message": "generic_client_error"
}

Allocate slots of an inventory to a user

post

Path parameters

ckeystringRequired

Body

application/json

Responses

201Success

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

post

/v1/community/{ckey}/inventory/slots/allocate

HTTPcURLJavaScriptPython

POST /v1/community/{ckey}/inventory/slots/allocate HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "slots": [
    {
      "slotId": "text",
      "itemId": "text"
    }
  ]
}

No content

Return the avatar of an user from an inventory

get

Path parameters

ckeystringRequired

Query parameters

userIdstringRequired

Responses

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

default

application/json

get

/v1/community/{ckey}/inventory/avatar

HTTPcURLJavaScriptPython

GET /v1/community/{ckey}/inventory/avatar?userId=text HTTP/1.1
Accept: */*

{
  "code": 10002,
  "message": "generic_client_error"
}

Return inventory items

get

Path parameters

ckeystringRequired

Query parameters

pagenumberOptional

limitnumberOptional

onlyOwnedstringRequired

userIdstringRequired

Responses

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

default

application/json

get

/v1/community/{ckey}/inventory/items

HTTPcURLJavaScriptPython

GET /v1/community/{ckey}/inventory/items?onlyOwned=text&userId=text HTTP/1.1
Accept: */*

{
  "code": 10002,
  "message": "generic_client_error"
}

Mint the Avatar of user as an NFT on a blockchain

post

Path parameters

ckeystringRequired

Body

application/json

blockchainstringRequired

Responses

201Success

400

Generic Client Error

application/json

401

Authentication related errors:

• GENERIC_UNAUTHORIZED: Generic unauthorized access error.
• SESSION_TOKEN_EXPIRED: User session has expired.
• REFRESH_TOKEN_EXPIRED: Refresh token has expired.

application/json

404

Generic not found

application/json

500

Internal server error

application/json

post

/v1/community/{ckey}/inventory/avatar/mint

HTTPcURLJavaScriptPython

POST /v1/community/{ckey}/inventory/avatar/mint HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "blockchain": "text"
}

No content