淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述

名称	类型	示例值	描述
output	OpenResponse		响应信息
└ trace_id String xxx 追踪id └ msg String xxx 响应信息(通常用于请求报错时，返回报错信息) └ code String xxx 响应码 data OpenUserFigureDTO 业务数据 └ user_id String xxx 用户id └ sex String MALE 性别 └ half_pic String https://xxx 半身照 clothes OpenClothesDTO [] 衣服 └ id Number 123 衣服id └ type String coat 衣服类型 mesh_info OpenMeshInfoDTO 衣服换装信息 └ sex Number 1 衣服模型的性别信息，只有男女，男 1 女 0 └ mesh_id String xxx 模型id └ material_id String xxx 材质id └ high_toe Number 1 高跟鞋（1代表开启高跟鞋，0或不填代表关闭高跟鞋） └ sub_type String xxx 子类型，目前是手持物相关 └ bone String xxx 骨骼信息，目前只有手持物才有 └ uuid String xxx 新美术流程资源唯一标识 └ is_new Boolean true 是否是新美术流程 └ art_extras String {} 新美术流程相关属性 gltf └ cocos_support Boolean true 是否支持cocos引擎 └ ue_support Boolean true 是否支持ue引擎 └ meta_support Boolean true 是否支持meta引擎 motion_info OpenMotionInfoDTO [] 模型数据 └ name String xxx 名称 └ uuid String xxx 新美术流程资源唯一标识 └ is_new Boolean true 是否是新美术流程 └ art_extras String {} 新美术流程相关属性 gltf face OpenFaceDTO 脸型 └ names String [] 控制杆名称 └ value String [] 值 makeup OpenMakeupDTO [] 妆容 └ id Number 1 妆容id └ cid Number 1 颜色id └ type String xxx 妆容类型 color_info OpenColorInfoDTO 颜色数据 └ id Number 1 用来关联的业务id └ icon_url String https://xxx 图标地址 └ rgb_img String https://xxx rgb图片 └ range_r Number [] 颜色数组(r) └ range_g Number [] 颜色数组(g) └ range_b Number [] 颜色数组(b) └ uuid String xxx 新美术流程资源唯一标识 └ is_new Boolean xxx 是否是新美术流程 └ art_extras String {} 新美术流程相关属性 gltf shape_info OpenShapeInfoDTO 形状数据 └ mesh_id String xxx 模型id └ texture_id String xxx 贴图id └ uuid String xxx 新美术流程资源唯一标识 └ is_new Boolean true 是否是新美术流程 └ art_extras String {} 新美术流程相关属性 gltf └ success Boolean true 是否成功 └ server_time Number 1669352100137 服务器时间

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
InteractionTblifeUserFigureGetRequest req = new InteractionTblifeUserFigureGetRequest();
InteractionTblifeUserFigureGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
InteractionTblifeUserFigureGetRequest req = new InteractionTblifeUserFigureGetRequest();
InteractionTblifeUserFigureGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new InteractionTblifeUserFigureGetRequest;
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.interaction.tblife.user.figure.get' \
-d 'partner_id=apidoc' \
-d 'session=37337c5d-9a33-4806-9bdb-74df82b6a48d' \
-d 'sign=FD8AC3D0A7611D7E850DEA6243167102' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-22+21%3A30%3A56' \
-d 'v=2.0'

# -*- coding: utf-8 -*-
import top.api

req=top.api.InteractionTblifeUserFigureGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.interaction.tblife.user.figure.get");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.interaction.tblife.user.figure.get' {
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<interaction_tblife_user_figure_get_response>
    <output>
        <trace_id>xxx</trace_id>
        <msg>xxx</msg>
        <code>xxx</code>
        <data>
            <user_id>xxx</user_id>
            <sex>MALE</sex>
            <half_pic>https://xxx</half_pic>
            <clothes>
                <open_clothes_d_t_o>
                    <id>123</id>
                    <type>coat</type>
                    <mesh_info>
                        <sex>1</sex>
                        <mesh_id>xxx</mesh_id>
                        <material_id>xxx</material_id>
                        <high_toe>1</high_toe>
                        <sub_type>xxx</sub_type>
                        <bone>xxx</bone>
                        <uuid>xxx</uuid>
                        <is_new>true</is_new>
                        <art_extras>{}</art_extras>
                        <cocos_support>true</cocos_support>
                        <ue_support>true</ue_support>
                        <meta_support>true</meta_support>
                    </mesh_info>
                    <motion_info>
                        <open_motion_info_d_t_o>
                            <name>xxx</name>
                            <uuid>xxx</uuid>
                            <is_new>true</is_new>
                            <art_extras>{}</art_extras>
                        </open_motion_info_d_t_o>
                    </motion_info>
                </open_clothes_d_t_o>
            </clothes>
            <face>
            </face>
            <makeup>
                <open_makeup_d_t_o>
                    <id>1</id>
                    <cid>1</cid>
                    <type>xxx</type>
                    <color_info>
                        <id>1</id>
                        <icon_url>https://xxx</icon_url>
                        <rgb_img>https://xxx</rgb_img>
                        <uuid>xxx</uuid>
                        <is_new>xxx</is_new>
                        <art_extras>{}</art_extras>
                    </color_info>
                    <shape_info>
                        <mesh_id>xxx</mesh_id>
                        <texture_id>xxx</texture_id>
                        <uuid>xxx</uuid>
                        <is_new>true</is_new>
                        <art_extras>{}</art_extras>
                    </shape_info>
                </open_makeup_d_t_o>
            </makeup>
        </data>
        <success>true</success>
        <server_time>1669352100137</server_time>
    </output>
</interaction_tblife_user_figure_get_response>

{
    "interaction_tblife_user_figure_get_response":{
        "output":{
            "trace_id":"xxx",
            "msg":"xxx",
            "code":"xxx",
            "data":{
                "user_id":"xxx",
                "sex":"MALE",
                "half_pic":"https:\/\/xxx",
                "clothes":{
                    "open_clothes_d_t_o":[
                        {
                            "id":123,
                            "type":"coat",
                            "mesh_info":{
                                "sex":1,
                                "mesh_id":"xxx",
                                "material_id":"xxx",
                                "high_toe":1,
                                "sub_type":"xxx",
                                "bone":"xxx",
                                "uuid":"xxx",
                                "is_new":true,
                                "art_extras":"{}",
                                "cocos_support":true,
                                "ue_support":true,
                                "meta_support":true
                            },
                            "motion_info":{
                                "open_motion_info_d_t_o":[
                                    {
                                        "name":"xxx",
                                        "uuid":"xxx",
                                        "is_new":true,
                                        "art_extras":"{}"
                                    }
                                ]
                            }
                        }
                    ]
                },
                "face":{
                },
                "makeup":{
                    "open_makeup_d_t_o":[
                        {
                            "id":1,
                            "cid":1,
                            "type":"xxx",
                            "color_info":{
                                "id":1,
                                "icon_url":"https:\/\/xxx",
                                "rgb_img":"https:\/\/xxx",
                                "uuid":"xxx",
                                "is_new":xxx,
                                "art_extras":"{}"
                            },
                            "shape_info":{
                                "mesh_id":"xxx",
                                "texture_id":"xxx",
                                "uuid":"xxx",
                                "is_new":true,
                                "art_extras":"{}"
                            }
                        }
                    ]
                }
            },
            "success":true,
            "server_time":1669352100137
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

淘宝互动平台开放招募

taobao.interaction.tblife.user.figure.get (获取(当前)用户形象)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ