文档中心 > API类目 > 麦座API

alibaba.damai.mz.user.baseinfo.get (会员基础信息查询)

大麦麦座用户基础信息查询接口。备注： 1、如果传两项及两项以上，查询优先级依次是，麦座会员id>麦座会员手机号>第三方会员id； 2、麦座用户登录标识，传此字段时，其他字段值忽略；

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
mz_user_id	String	可选	83121114		麦座会员用户id
mobile_phone	String	可选	15801234567		麦座会员手机号
third_user_id	String	可选	66888	最大长度：32	第三方会员用户id
mz_user_login_token	String	可选	3d825ad062db45349de8bac73cad5e6e	最大长度：50	麦座用户登录标识；传此字段时，其他字段值忽略；

响应参数

名称	类型	示例值	描述
result	ResultData		请求结果
└ msg String 成功提示信息 └ code String 200 状态码 data UserOpenBaseInfoVo 麦座会员基础信息 └ birthday String 1988-08-01 生日 └ sex Number 1 用户性别：1=男，2=女，0=保密 └ nick_name String 晴x雪昵称 └ email String xxx@sina.com 邮箱 └ mobile_phone String 15801234567 麦座会员手机号 └ third_user_id String 4131111231 第三方会员ID └ mz_user_id String 83121114 麦座用户id └ user_level_name String 一级会员等级名称 └ user_level_id String 89301 会员等级id └ province_code Number 110000 省份代码；中国民政部行政区划代码 └ province_name String 北京省份名称 └ city_code Number 110000 城市代码；中国民政部行政区划代码 └ city_name String 北京市城市名称 └ area_code Number 110105 县/区代码；中国民政部行政区划代码 └ area_name String 朝阳区县/区名称 └ address String XXX大街XX号用户街道详细地址 └ real_name String 张三证件真实姓名；realName与（lastName+firstName）至少传一项 └ first_name String 三证件名 └ last_name String 张证件姓 └ card_no String 110xxxxxxxxxxxxxx1 证件号(暂时只支持身份证) └ card_type Number 1 证件类型: 1=身份证号,2=护照,3=港澳通行证,4=台胞证(暂时只支持身份证)

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzUserBaseinfoGetRequest req = new AlibabaDamaiMzUserBaseinfoGetRequest();
req.setMzUserId("83121114");
req.setMobilePhone("15801234567");
req.setThirdUserId("66888");
req.setMzUserLoginToken("3d825ad062db45349de8bac73cad5e6e");
AlibabaDamaiMzUserBaseinfoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<alibaba_damai_mz_user_baseinfo_get_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <birthday>1988-08-01</birthday>
            <sex>1</sex>
            <nick_name>晴x雪</nick_name>
            <email>xxx@sina.com</email>
            <mobile_phone>15801234567</mobile_phone>
            <third_user_id>4131111231</third_user_id>
            <mz_user_id>83121114</mz_user_id>
            <user_level_name>一级</user_level_name>
            <user_level_id>89301</user_level_id>
            <province_code>110000</province_code>
            <province_name>北京</province_name>
            <city_code>110000</city_code>
            <city_name>北京市</city_name>
            <area_code>110105</area_code>
            <area_name>朝阳区</area_name>
            <address>XXX大街XX号</address>
        </data>
    </result>
</alibaba_damai_mz_user_baseinfo_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>

错误码解释

错误码	错误描述	解决方案
40100000	api未知错误	通用系统异常
40100001	api请求失败	通用业务异常
40100006	请求必须的参数麦座会员id不能为空	请求必须的参数麦座会员id不能为空
40101001	手机号格式有误	手机号格式有误
16010014	手机号格式错误	手机号格式错误
16020001	会员不存在	会员不存在
16020002	手机号不存在	手机号不存在
16050002	查询信息异常，请稍后重试	查询信息异常，请稍后重试
16050003	根据手机号或邮箱查询信息异常，请稍后重试	根据手机号或邮箱查询信息异常，请稍后重试

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

麦座API

alibaba.damai.mz.user.baseinfo.get (会员基础信息查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ