四、用户相关

4.1 用户信息

1. 接口说明

获取当前用户详情数据

2. 请求地址

GET api/v3/user/user_info/

3. 请求参数

无

4. 返回示例

{
  "msg": "",
  "status": "",
  "results": {
    "nickname": "",
    "username": "",
    "birthday": "",
    "user_image": "",
    "face_image": "",
    "generate_face_image": "",
    "id_card": "",
    "real_name": "",
    "real_name_status": "",
    "user_integer": "",
    "have_prize": "",
    "have_airdrop": "",
    "is_hint_modify_pass": "",
    "is_ver_invt_code": "",
    "is_receive_num_card": "",
    "receive_num_card_date": "",
    "remarks": "",
    "id": "",
    "is_init": "",
    "figure_is_selected_id": "",
    "first_view_airdrop": "",
    "has_fan_card": ""
  }
}

5. 返回示例说明

results对象

参数	说明	字段类型
nickname	昵称	string
username	手机号	string
birthday	生日	string
user_image	形象	array
face_image	头像	string
generate_face_image	生成头像	string
id_card	身份证号	string
real_name	真实姓名	string
real_name_status	用户认证状态	integer
user_integer	用户吊卡标识	integer
have_prize	是否参数中奖	boolean
have_airdrop	是否参与空投	boolean
is_hint_modify_pass	是否弹窗提示修改密码	boolean
is_ver_invt_code	是否关联品牌	boolean
is_receive_num_card	是否领取数字身份证	boolean
receive_num_card_date	领取数字身份证时间	string
remarks	备注	string
id	唯一标识	integer
is_init	是否初始化	boolean
figure_is_selected_id	角色标识	integer
first_view_airdrop	是否查看空投	boolean
has_fan_card	是否领取粉丝卡	boolean

4.2 更新用户头像

1. 接口说明

用生成的头像，替换当前头像

2. 请求地址

POST  /api/v3/user/modify_face_image/

3. 请求参数

无

4. 返回示例

{
  "msg": "ok",
  "stauts": 200
}

5. 返回示例说明

无

4.3 衣橱数据

1. 接口说明

获取用户当前衣橱数据

2. 请求地址

GET /api/v3/user/my/

3. 请求参数

参数	说明	字段类型	是否必传
is_ar	获取ar资产	boolean	否

# 示例
{
    "is_ar": true
}

4. 返回示例

{
  "id": "",
  "pattern": "",
  "suit": "",
  "is_suit": "",
  "create_time": "",
  "creator": "",
  "is_delete": "",
  "update_time": "",
  "update_user": "",
  "nft_id": "",
  "user": "",
  "b_end": ""
}

5. 返回示例说明

参数	说明	字段类型
id	唯一标识	integer
pattern	资产对象	object
suit	套装对象	object
is_suit	该记录是否为套装	boolean
nft_id	nft链上标识	integer
user	用户标识	integer
b_end	B端标识	integer

4.4 创建形象搭配

1. 接口说明

创建当前形象的搭配

2. 请求地址

POST  /api/v3/user_image/image_collocation/

3. 请求参数

字段名称	字段类型	字段说明
pattern	array	形象资产
suit	array	形象套装
thumbnail	string	搭配缩略图
face_json	string	形象face_json
body_json	string	形象body_json
gender	string	形象性别
image_collocation_color	array	形象颜色
figure_library	integer	形象角色

# 示例
{
    "pattern": [1,2],
    "suit": [3,4],
    "thumbnail": "https://",
    "face_json": "",
    "body_json": "",
    "gender": "",
    "image_collocation_color": [],
    "figure_library": 1
}

4. 返回示例

{
    "msg": "ok",
    "status": 200
}

5. 返回示例说明

无

4.5 获取形象搭配列表

1. 接口说明

获取当前形象搭配

2. 请求地址

GET /api/v3/user_image/image_collocation/

3. 请求参数

段名称	字段类型	字段说明	是否必传
user_image_id	integer	形象唯一标识	是

# 示例
{
    "user_image_id": 1
}

4. 返回示例

{
    "msg": "ok",
    "status": 200,
    "results": [
        {
            "id": 1,
            "pattern": [
                {
                    "id": 4,
                    "user_count": 0,
                    "tags": {},
                    "same_name_tag": null,
                    "brand_logo": "",
                    "brand_logo1": "",
                    "have_nft": false,
                    "issuer": "跨克因子",
                    "suit_status": false,
                    "nft_price": "0.01",
                    "inventory": 5,
                    "create_time": "2022-09-22 16:46:46",
                    "creator": null,
                    "is_delete": false,
                    "name": "sceneBgColor_001",
                    "thumbnail": null,
                    "thumbnail52": null,
                    "ma_file": null,
                    "fbx_file": null,
                    "obb_file": null,
                    "android_pak_file_astc": null,
                    "android_pak_file_dxt": null,
                    "android_pak_file_etc2": null,
                    "ios_pak_file": null,
                    "json_file": null,
                    "order": null,
                    "blend_shape": null,
                    "web_gl": null,
                    "nft_name": null,
                    "nft_issue_number": 10,
                    "nft_surplus": 100,
                    "lock_up_volume": 5,
                    "usage_number": 0,
                    "is_up_chain": 2,
                    "is_nft": true,
                    "introduction": null,
                    "nft_author": "跨克因子",
                    "glb_file": null,
                    "display_url": null,
                    "hash_glb": null,
                    "md5_glb": null,
                    "status": 1,
                    "nft_publish_ts": null,
                    "is_set": false,
                    "translate": [
                        0,
                        0,
                        0
                    ],
                    "rotate": [
                        0,
                        0,
                        0
                    ],
                    "scale": [
                        1,
                        1,
                        1
                    ],
                    "bones_point_name": "",
                    "modify_nft_price": "0.00",
                    "modify_nft_price_take_effect_time": null,
                    "genre": null,
                    "thumbnail600": null,
                    "thumbnail1024": null,
                    "video": null,
                    "series": null,
                    "brand": null
                },
                {
                    "id": 5,
                    "user_count": 0,
                    "tags": {},
                    "same_name_tag": null,
                    "brand_logo": "",
                    "brand_logo1": "",
                    "have_nft": false,
                    "issuer": "跨克因子",
                    "suit_status": true,
                    "nft_price": "0.01",
                    "inventory": 5,
                    "create_time": "2022-09-22 16:46:46",
                    "creator": null,
                    "is_delete": false,
                    "name": "sceneBgColor_002",
                    "thumbnail": null,
                    "thumbnail52": null,
                    "ma_file": null,
                    "fbx_file": null,
                    "obb_file": null,
                    "android_pak_file_astc": null,
                    "android_pak_file_dxt": null,
                    "android_pak_file_etc2": null,
                    "ios_pak_file": null,
                    "json_file": null,
                    "order": null,
                    "blend_shape": null,
                    "web_gl": null,
                    "nft_name": null,
                    "nft_issue_number": 10,
                    "nft_surplus": 100,
                    "lock_up_volume": 5,
                    "usage_number": 0,
                    "is_up_chain": 2,
                    "is_nft": true,
                    "introduction": null,
                    "nft_author": "跨克因子",
                    "glb_file": null,
                    "display_url": null,
                    "hash_glb": null,
                    "md5_glb": null,
                    "status": 1,
                    "nft_publish_ts": null,
                    "is_set": false,
                    "translate": [
                        0,
                        0,
                        0
                    ],
                    "rotate": [
                        0,
                        0,
                        0
                    ],
                    "scale": [
                        1,
                        1,
                        1
                    ],
                    "bones_point_name": "",
                    "modify_nft_price": "0.00",
                    "modify_nft_price_take_effect_time": null,
                    "genre": null,
                    "thumbnail600": null,
                    "thumbnail1024": null,
                    "video": null,
                    "series": null,
                    "brand": null
                },
                {
                    "id": 6,
                    "user_count": 0,
                    "tags": {},
                    "same_name_tag": null,
                    "brand_logo": "",
                    "brand_logo1": "",
                    "have_nft": false,
                    "issuer": "跨克因子",
                    "suit_status": true,
                    "nft_price": "0.01",
                    "inventory": 5,
                    "create_time": "2022-09-22 16:46:46",
                    "creator": null,
                    "is_delete": false,
                    "name": "sceneBgColor_003",
                    "thumbnail": null,
                    "thumbnail52": null,
                    "ma_file": null,
                    "fbx_file": null,
                    "obb_file": null,
                    "android_pak_file_astc": null,
                    "android_pak_file_dxt": null,
                    "android_pak_file_etc2": null,
                    "ios_pak_file": null,
                    "json_file": null,
                    "order": null,
                    "blend_shape": null,
                    "web_gl": null,
                    "nft_name": null,
                    "nft_issue_number": 10,
                    "nft_surplus": 100,
                    "lock_up_volume": 5,
                    "usage_number": 0,
                    "is_up_chain": 2,
                    "is_nft": true,
                    "introduction": null,
                    "nft_author": "跨克因子",
                    "glb_file": null,
                    "display_url": null,
                    "hash_glb": null,
                    "md5_glb": null,
                    "status": 1,
                    "nft_publish_ts": null,
                    "is_set": false,
                    "translate": [
                        0,
                        0,
                        0
                    ],
                    "rotate": [
                        0,
                        0,
                        0
                    ],
                    "scale": [
                        1,
                        1,
                        1
                    ],
                    "bones_point_name": "",
                    "modify_nft_price": "0.00",
                    "modify_nft_price_take_effect_time": null,
                    "genre": null,
                    "thumbnail600": null,
                    "thumbnail1024": null,
                    "video": null,
                    "series": null,
                    "brand": null
                }
            ],
            "suit": [
                {
                    "id": 1,
                    "pattern": [
                        {
                            "id": 5,
                            "user_count": 0,
                            "tags": {},
                            "same_name_tag": null,
                            "brand_logo": "",
                            "brand_logo1": "",
                            "have_nft": false,
                            "issuer": "跨克因子",
                            "suit_status": true,
                            "nft_price": "0.01",
                            "inventory": 5,
                            "create_time": "2022-09-22 16:46:46",
                            "creator": null,
                            "is_delete": false,
                            "name": "sceneBgColor_002",
                            "thumbnail": null,
                            "thumbnail52": null,
                            "ma_file": null,
                            "fbx_file": null,
                            "obb_file": null,
                            "android_pak_file_astc": null,
                            "android_pak_file_dxt": null,
                            "android_pak_file_etc2": null,
                            "ios_pak_file": null,
                            "json_file": null,
                            "order": null,
                            "blend_shape": null,
                            "web_gl": null,
                            "nft_name": null,
                            "nft_issue_number": 10,
                            "nft_surplus": 100,
                            "lock_up_volume": 5,
                            "usage_number": 0,
                            "is_up_chain": 2,
                            "is_nft": true,
                            "introduction": null,
                            "nft_author": "跨克因子",
                            "glb_file": null,
                            "display_url": null,
                            "hash_glb": null,
                            "md5_glb": null,
                            "status": 1,
                            "nft_publish_ts": null,
                            "is_set": false,
                            "translate": [
                                0,
                                0,
                                0
                            ],
                            "rotate": [
                                0,
                                0,
                                0
                            ],
                            "scale": [
                                1,
                                1,
                                1
                            ],
                            "bones_point_name": "",
                            "modify_nft_price": "0.00",
                            "modify_nft_price_take_effect_time": null,
                            "genre": null,
                            "thumbnail600": null,
                            "thumbnail1024": null,
                            "video": null,
                            "series": null,
                            "brand": null
                        },
                        {
                            "id": 6,
                            "user_count": 0,
                            "tags": {},
                            "same_name_tag": null,
                            "brand_logo": "",
                            "brand_logo1": "",
                            "have_nft": false,
                            "issuer": "跨克因子",
                            "suit_status": true,
                            "nft_price": "0.01",
                            "inventory": 5,
                            "create_time": "2022-09-22 16:46:46",
                            "creator": null,
                            "is_delete": false,
                            "name": "sceneBgColor_003",
                            "thumbnail": null,
                            "thumbnail52": null,
                            "ma_file": null,
                            "fbx_file": null,
                            "obb_file": null,
                            "android_pak_file_astc": null,
                            "android_pak_file_dxt": null,
                            "android_pak_file_etc2": null,
                            "ios_pak_file": null,
                            "json_file": null,
                            "order": null,
                            "blend_shape": null,
                            "web_gl": null,
                            "nft_name": null,
                            "nft_issue_number": 10,
                            "nft_surplus": 100,
                            "lock_up_volume": 5,
                            "usage_number": 0,
                            "is_up_chain": 2,
                            "is_nft": true,
                            "introduction": null,
                            "nft_author": "跨克因子",
                            "glb_file": null,
                            "display_url": null,
                            "hash_glb": null,
                            "md5_glb": null,
                            "status": 1,
                            "nft_publish_ts": null,
                            "is_set": false,
                            "translate": [
                                0,
                                0,
                                0
                            ],
                            "rotate": [
                                0,
                                0,
                                0
                            ],
                            "scale": [
                                1,
                                1,
                                1
                            ],
                            "bones_point_name": "",
                            "modify_nft_price": "0.00",
                            "modify_nft_price_take_effect_time": null,
                            "genre": null,
                            "thumbnail600": null,
                            "thumbnail1024": null,
                            "video": null,
                            "series": null,
                            "brand": null
                        }
                    ],
                    "have_suit": false,
                    "create_time": "2022-09-23 11:10:36",
                    "creator": null,
                    "is_delete": false,
                    "name": "开发套装",
                    "thumbnail": null,
                    "thumbnail52": null,
                    "price": "0.01",
                    "upper_limit": 1,
                    "sold_num": 0,
                    "lock_up_volume": 0,
                    "threshold": 1,
                    "sell_out": false,
                    "status": 1
                }
            ],
            "thumbnail": "http://fjdaoifhiabsdfio.com"
        }
    ]
}

5. 返回示例说明

results

字段名称	字段类型	字段说明
id	integer	唯一标识
pattern	array	形象资产
suit	array	形象套装
thumbnail	string	搭配缩略图
face_json	string	形象face_json
body_json	string	形象body_json
gender	string	形象性别
image_collocation_color	array	形象颜色

4.5 删除形象搭配

1. 接口说明

删除指定搭配

2. 请求地址

DELETE  /api/v3/user_image/image_collocation/{id}

3. 请求参数

段名称	字段类型	字段说明	是否必传
id	integer	搭配唯一标识	是

# 示例
/api/v3/user_image/image_collocation/1

4. 返回示例

{
    "msg": "ok",
    "status": 200
}

5.返回示例说明

无

4.6 获取方案

1. 接口说明

获取方案

2. 请求地址

GET /api/v3/to_b/scheme/

3. 请求参数

段名称	字段类型	字段说明	是否必传
id	integer	方案唯一标识	是

# 示例
/api/v3/user_image/image_collocation/?id=1

4. 返回示例

{
    "msg": "ok",
    "status": 200
}{
    "msg": "string",
    "status": 0,
    "results": {
        "count": 0,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 0,
                "scheme": {
                    "id": 0,
                    "name": "string",
                    "production_process": "string",
                    "tags": {
                        "callingUEInterfaceName": [
                            {
                                "id": 0,
                                "create_time": "string",
                                "creator": "string",
                                "is_delete": true,
                                "update_time": "string",
                                "update_user": null,
                                "name": "string",
                                "help_text": "string",
                                "is_modify": true
                            }
                        ]
                    },
                    "rgb_scheme": [
                        {
                            "color_id": 0,
                            "color_value": "string"
                        }
                    ],
                    "rgb_recommend_scheme": [
                        {
                            "color_id": 0,
                            "color_value": "string"
                        }
                    ],
                    "picture_scheme": [
                        {
                            "pattern_id": 0,
                            "pattern_thumbnail": "string",
                            "pattern_ios_pak_file": "string",
                            "pattern_obb_file": "string",
                            "info_is_reselection": true,
                            "info_calling_interface_name": "string",
                            "info_asset_mutual_exclusion": [
                                "string"
                            ]
                        }
                    ],
                    "picture_recommend_scheme": [
                        {
                            "pattern_id": 0,
                            "pattern_thumbnail": "string",
                            "pattern_ios_pak_file": "string",
                            "pattern_obb_file": "string",
                            "info_is_reselection": true,
                            "info_calling_interface_name": "string",
                            "info_asset_mutual_exclusion": [
                                "string"
                            ]
                        }
                    ]
                },
                "engine": 0,
                "b_end": 0
            }
        ]
    }
}

5.返回示例说明

results

字段名称	字段类型	字段说明
id	integer	b端方案唯一标识
scheme	object	方案
engine	string	引擎
b_end	integer	b端唯一标识

scheme

字段名称	字段类型	字段说明
id	integer	方案唯一标识
name	object	方案名
production_process	string	制作工艺
tags	object	标签
rgb_scheme	object	rgb
rgb_recommend_scheme	object	rgb推荐
picture_scheme	object	贴图
picture_recommend_scheme	object	贴图推荐

rgb_scheme

字段名称	字段类型	字段说明
id	integer	b端方案唯一标识
name	object	方案名
production_process	string	制作工艺

picture_scheme

字段名称	字段类型	字段说明
pattern_id	integer	资产唯一标识
pattern_thumbnail	string	缩略图
pattern_ios_pak_file	string	iospak
pattern_obb_file	string	安卓 obb文件
info_is_reselection	boolean	是否支持反选
info_calling_interface_name	string	调用接口名称
info_asset_mutual_exclusion