阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
subscriber_nick	String	可选	cntaobaobuyer		卡片接受者nick

名称	类型	示例值	描述
error_message	String	demo	errorMessage
module	Boolean	false	发送结果

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
QianniuBcpushSendSubscribecardRequest req = new QianniuBcpushSendSubscribecardRequest();
req.setSubscriberNick("cntaobaobuyer");
QianniuBcpushSendSubscribecardResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
QianniuBcpushSendSubscribecardRequest req = new QianniuBcpushSendSubscribecardRequest();
req.SubscriberNick = "cntaobaobuyer";
QianniuBcpushSendSubscribecardResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new QianniuBcpushSendSubscribecardRequest;
$req->setSubscriberNick("cntaobaobuyer");
$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.qianniu.bcpush.send.subscribecard' \
-d 'partner_id=apidoc' \
-d 'session=b914f6dc-69ba-4626-a4c0-3dbe8372151a' \
-d 'sign=FCC9FF5C5E8E395409D468BE480621D2' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-26+14%3A28%3A02' \
-d 'v=2.0' \
-d 'subscriber_nick=cntaobaobuyer'

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

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

req.subscriber_nick="cntaobaobuyer"
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.qianniu.bcpush.send.subscribecard");
add_param(pRequest,"subscriber_nick","cntaobaobuyer");
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.qianniu.bcpush.send.subscribecard', {
	'subscriber_nick':'cntaobaobuyer'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<qianniu_bcpush_send_subscribecard_response>
    <error_message>demo</error_message>
    <module>false</module>
</qianniu_bcpush_send_subscribecard_response>

{
    "qianniu_bcpush_send_subscribecard_response":{
        "error_message":"demo",
        "module":false
    }
}

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.qianniu.bcpush.send.subscribecard (bc消息下行发送订阅卡片)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈