文档中心 > API类目 > 阿里通信API

alibaba.aliqin.tcc.trade.identity.get (运营商获得用户身份信息)

天猫网厅运营商官方旗舰店获取用户身份信息

公共参数

请求地址：

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
biz_order_id	Number	必须	192470811201211		订单编号
seller_nick	String	必须	tworkb8423		店铺名称

响应参数

名称	类型	示例值	描述
result	IdentityInfo		返回身份信息
└ back_image_url String http://oss.taobao.com/3212.jpg 身份证背面图片 └ biz_order_id Number 192470811191211 订单id └ card_num String 339005198010109999 身份证号码 └ front_image_url String http://oss.taobao.com/3212.jpg 身份证正面图片 └ hold_image_url String http://oss.taobao.com/3212.jpg 手持照 └ name String 张三姓名 └ address String 浙江省杭州市地址 └ long_term Boolean false 是否长期有效 └ card_type String 1 卡类型 └ card_expire_date Date 2036-01-01 失效时间 └ start_date String 2016-01-01 身份证生效时间 └ end_date String 2036-01-01 身份证失效时间 └ biometric_seq String biometricSeq biometricSeq └ contact_info String json串套餐合约相关信息

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAliqinTccTradeIdentityGetRequest req = new AlibabaAliqinTccTradeIdentityGetRequest();
req.setBizOrderId(192470811201211L);
req.setSellerNick("tworkb8423");
AlibabaAliqinTccTradeIdentityGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<alibaba_aliqin_tcc_trade_identity_get_response>
    <result>
        <back_image_url>http://oss.taobao.com/3212.jpg</back_image_url>
        <biz_order_id>192470811191211</biz_order_id>
        <card_num>339005198010109999</card_num>
        <front_image_url>http://oss.taobao.com/3212.jpg</front_image_url>
        <hold_image_url>http://oss.taobao.com/3212.jpg</hold_image_url>
        <name>张三</name>
        <address>浙江省杭州市</address>
        <long_term>false</long_term>
        <card_type>1</card_type>
        <card_expire_date>2036-01-01</card_expire_date>
        <start_date>2016-01-01</start_date>
        <end_date>2036-01-01</end_date>
        <biometric_seq>biometricSeq</biometric_seq>
        <contact_info>json串</contact_info>
    </result>
</alibaba_aliqin_tcc_trade_identity_get_response>

异常示例

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>

错误码解释

错误码	错误描述	解决方案
isv.param-is-illegal	输入参数不合法	请检查输入的参数,输入参数为订单号,只能为数字
isv.not-allow	无权限使用该接口	确认是否为运营商旗舰店
isv.system-error	系统内部错误	系统内部出错，请联系系统管理员
isv.no-record	记录不存在	查询的记录不存在

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部