淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
member_query	MemberQueryRequest	可选			系统自动生成
└ merchant_code String 可选 TAOXIANDA 商户号 └ member_attributes String 可选 {"key":"value"} 扩展字段json字符串 └ account_type String 可选 cardNum 会员类型 └ account_id String 可选 12345678 会员号

名称	类型	示例值	描述
api_result	ApiResult	apiResult	结果
└ success Boolean true 是否成功 └ err_msg String 成功错误消息 └ err_code String success 错误结果码 model MemberInfoDo model 会员信息模型 └ card_level Number 1 会员卡等级 └ card_num String 123434512 会员卡号 └ state String 使用中会员卡状态 '使用中' or '已挂失' or '已作废' or '已补发卡' or '已退卡' or '已冻结' or '未激活' or '已坏卡登记' or '已销毁' or '已制卡' or '已发卡' or '已核对' or '已回收' or '空卡' or '异常' or '已损卡' └ end_time String 2019-09-09 00:00:00 卡有效期截止日期，格式：yyyy-MM-dd HH:mm:ss └ forever Boolean true 如果卡长期有效，值为true，为true时，默认不校验endTime └ member_attributes String {"key":"value"} 扩展属性map └ card_type String 0 会员卡类型

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkMemberCardGetRequest req = new AlibabaWdkMemberCardGetRequest();
AlibabaWdkMemberCardGetRequest.MemberQueryRequest obj1 = new AlibabaWdkMemberCardGetRequest.MemberQueryRequest();
obj1.setMerchantCode("TAOXIANDA");
obj1.setMemberAttributes("{\"key\":\"value\"}");
obj1.setAccountType("cardNum");
obj1.setAccountId("12345678");
req.setMemberQuery(obj1);
AlibabaWdkMemberCardGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaWdkMemberCardGetRequest req = new AlibabaWdkMemberCardGetRequest();
AlibabaWdkMemberCardGetRequest.MemberQueryRequestDomain obj1 = new AlibabaWdkMemberCardGetRequest.MemberQueryRequestDomain();
obj1.MerchantCode = "TAOXIANDA";
obj1.MemberAttributes = "{\"key\":\"value\"}";
obj1.AccountType = "cardNum";
obj1.AccountId = "12345678";
req.MemberQuery_ = obj1;
AlibabaWdkMemberCardGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaWdkMemberCardGetRequest;
$member_query = new MemberQueryRequest;
$member_query->merchant_code="TAOXIANDA";
$member_query->member_attributes="{\"key\":\"value\"}";
$member_query->account_type="cardNum";
$member_query->account_id="12345678";
$req->setMemberQuery(json_encode($member_query));
$resp = $c->execute($req);

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=alibaba.wdk.member.card.get' \
-d 'partner_id=apidoc' \
-d 'sign=788EC3E499F36863C2C415515B4CE430' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-25+14%3A57%3A02' \
-d 'v=2.0' \
-d 'member_query=null'

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

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

req.member_query=""
try:
	resp= req.getResponse()
	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,"alibaba.wdk.member.card.get");
add_param(pRequest,"member_query","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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('alibaba.wdk.member.card.get', {
	'member_query':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_wdk_member_card_get_response>
    <api_result>
        <success>true</success>
        <err_msg>成功</err_msg>
        <err_code>success</err_code>
        <model>
            <card_level>1</card_level>
            <card_num>123434512</card_num>
            <state>使用中</state>
            <end_time>2019-09-09 00:00:00</end_time>
            <forever>true</forever>
            <member_attributes>{&quot;key&quot;:&quot;value&quot;}</member_attributes>
            <card_type>0</card_type>
        </model>
    </api_result>
</alibaba_wdk_member_card_get_response>

{
    "alibaba_wdk_member_card_get_response":{
        "api_result":{
            "success":true,
            "err_msg":"成功",
            "err_code":"success",
            "model":{
                "card_level":1,
                "card_num":"123434512",
                "state":"使用中",
                "end_time":"2019-09-09 00:00:00",
                "forever":true,
                "member_attributes":"{\"key\":\"value\"}",
                "card_type":"0"
            }
        }
    }
}

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下载

五道口API

alibaba.wdk.member.card.get (查询会员卡信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ