Get Customization

开发环境

http://dev-cn.your-api-server.com

GET

/api/v1/avatars/{id}/customization

Get current avatar customization.

Customization is the combination of applied assets
(clothes, hairstyles, accessories etc),
as well as the body type and other parameters.

NOTE: Behavior of this endpoint for avatars created by direct photo upload and
not yet opened via browser UNDEFINED and can be changed in the future.
Set customization via corresponding endpoint to get predictable behaviour.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/api/v1/avatars//customization'

响应示例

200 - 示例 1

{
    "assets": {
        "clothing": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        },
        "hair_and_headwear": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "color": "#aabbcc"
        },
        "eyewear": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "color": "#aabbccaa"
        },
        "footwear": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        }
    },
    "body": "body_0",
    "age": "adult",
    "metadata": {
        "property1": "string",
        "property2": "string"
    },
    "bone_scale": {
        "head": 0,
        "arms": 0,
        "chest": 0
    },
    "skin_tone_correction": 0
}

请求参数

Path 参数

string <uuid>

必需

返回响应

🟢200Successful Response

application/json

Body

assets

object (AssetSlots)

必需

clothing

可选

hair_and_headwear

可选

eyewear

可选

footwear

可选

body

enum<string>

必需

Avatar body type

枚举值:

body_0body_1body_2body_3body_4

age

enum<string>

Age

可选

枚举值:

3-67-1213-16adult

默认值:

adult

metadata

object

Metadata

可选

Arbitrary key-value pairs. Use them to store any data associated with avatar. 10 pairs max, 50 chars max key length, 500 chars max value length

额外字段

string

可选

<= 500 字符

bone_scale

object (BoneScale)

可选

head

number

Head

可选

默认值:

arms

number

Arms

可选

默认值:

chest

number

Chest

可选

默认值:

skin_tone_correction

number

Skin Tone Correction

可选

默认值:

🟠422Validation Error

修改于 2024-05-30 08:40:21

New Avatar

Set Customization