淘宝客-推广者-商品链接转换
淘宝客-公用-淘宝客商品详情查询(简版)
淘宝客-推广者-商品三方分成链接转换
淘宝客-推广者-店铺搜索
淘宝客-公用-店铺关联推荐
淘宝客-推广者-店铺链接转换
淘宝客-推广者-店铺三方分成链接转换
淘宝客-公用-长链转短链
淘宝客-推广者-根据宝贝id批量查询优惠券
淘宝客-公用-链接解析出商品id
淘宝客-服务商-保护门槛
淘宝客-服务商-单品券高效转链
淘宝客-推广者-单品券高效转链
淘宝客-公用-阿里妈妈推广券详情查询
淘宝客-公用-淘口令生成
淘宝客-推广者-创建推广位
淘宝客-公用-文本淘口令
淘宝客-推广者-淘口令解析&三方分成转链
淘宝客-推广者-淘口令解析&转链
淘宝客-推广者-新用户订单明细查询
淘宝客-服务商-新用户订单明细查询
淘宝客-推广者-物料精选
淘宝客-服务商-创建推广者位
淘宝客-服务商-物料搜索
淘宝客-推广者-物料搜索
淘宝客-推广者-拉新活动对应数据查询
淘宝客-服务商-拉新活动数据查询
淘宝客-服务商-物料精选
淘宝客-公用-私域用户备案
淘宝客-公用-私域用户备案信息查询
淘宝客-公用-私域用户邀请码生成
淘宝客-公用-pid校验
淘宝客-推广者-售后退款订单查询
淘宝客-推广者-淘礼金创建
报表查询
淘宝客-服务商-处罚订单查询
淘宝客-推广者-处罚订单查询
淘宝客-公用-淘口令解析出原链接
淘宝客-推广者-图文智能识别消费者端推荐物料查询
淘宝客-推广者-图文智能识别达人端物料上传
淘宝客-推广者-所有订单查询
淘宝客-服务商-所有订单查询
淘宝客-服务商-淘口令解析&转链
淘宝客-服务商-售后退款订单查询
淘宝客-服务商-店铺链接转换
淘宝客-推广者-媒体数据报表交换
淘宝客-推广者-官办找福利页
淘宝客-推广者-物料上行
淘宝客-推广者-媒体数据报表交换-汇总数据
淘宝客-推广者-媒体数据交换报表点击维度
淘宝客-公用-淘宝客商品详情查询(详细版)
淘宝客-推广者-快手日报(达人维度)
淘宝客-推广者-达人实时销量汇总数据
淘宝客-推广者-快手月报(达人维度)
内容媒体-达人实时销量榜单
淘宝客-服务商-查询红包发放个数
淘宝客-推广者-查询红包发放个数
淘宝客商品展示规则获取
淘宝客-推广者-微博日报(达人维度)
淘宝客-推广者-微博月报(达人维度)
淘宝客-推广者-官方活动转链
淘宝客-服务商-官方活动转链
淘宝客-推广者-媒体智能化投放
淘宝客-招商团长-服务费订单明细
淘宝客-工具-团长-所有订单查询
淘宝客-推广者-渠道管理组团明细数据
淘宝客-推广者-渠道管理组团汇总数据
淘宝客-服务商-渠道管理rid推广效果
淘宝客-推广者-权益物料精选
淘宝客-服务商-权益物料精选
淘宝客-服务商-红包领取状态查询
淘宝客-推广者-红包领取状态查询
淘宝客-推广者-拍立淘插件转链
淘宝客-服务商-创建人群标签
淘宝客-服务商-私域会员标记
淘宝客-服务商-上传人群数据
淘宝客-服务商-拍立淘插件转链
淘宝客-服务商-商业化图片生成
购物车催付优惠券到期查询用户信息
淘宝客-服务商-人群推广效果
sku维度最优优惠券信息
淘宝客-推广者-互动任务投放
淘宝联盟厂商找优惠
淘宝客-服务商-定向活动目标发布
淘宝客-推广者-定向活动目标发布
淘宝客-推广者-CPA活动执行明细
淘宝客-推广者-淘口令回流数据查询
淘宝客-服务商-淘口令回流数据查询
淘宝客-服务商-CPA活动执行明细
淘宝客-推广者-加密淘口令生成
淘宝客-服务商-加密淘口令生成
淘宝客-推广者-任务奖励效果报表
淘宝客-服务商-任务奖励效果报表
淘宝客-推广者-淘礼金暂停发放
淘宝客-推广者-淘礼金效果数据
淘宝客-推广者-淘口令预警及拦截查询
淘宝客-服务商-淘口令预警及拦截查询
淘宝客-推广者-淘礼金三方链接转换
淘宝客-服务商-单品推荐
淘宝客-推广者-种草指标报表
淘宝客-服务商-物料精选升级版
淘宝客-推广者-物料精选升级版
淘宝客-推广者-内容种草人群包数据查询
淘宝客-推广者-内容ID订单汇总
淘宝客-服务商-member组查询&新增
淘宝客-推广者-商品id升级(三方)
淘宝客-推广者-商品id转化(二方)(专有)
淘宝客-推广者-物料id列表查询
淘宝客-服务商-爆料分享物料获取
淘宝客-推广者-爆料分享物料获取
淘宝客-公用-爆料分享物料上传
淘宝客-推广者-内容种草任务列表下行
淘宝客-推广者-种草内容数据写入
淘宝客-推广者-导购数据上传
淘宝客-公用-淘宝客商品详情查询升级版(详细版)
淘宝客-服务商-物料搜索升级版
淘宝客-推广者-物料搜索升级版
淘宝客-公用-淘宝客商品详情查询升级版(简易版)
淘宝客-推广者-全量售后退款订单查询
淘宝客-公用-失效商品id转化
淘宝客-服务商-全量售后退款订单查询
淘宝客-推广者-万能转链
淘宝客-服务商-万能转链
淘宝客-推广者-内容种草投流明细数据上传
淘宝客-推广者-多品凑单上传
淘宝客-推广者-内容投流关系写入
淘宝客-推广者-内容种草投流前链路数据上传
淘宝客-推广者-内容种草投流数据交换
淘宝客-推广者-投流任务信息下行
淘宝客-推广者-加密用户标识生成
淘宝客-推广者-种草商单子任务改价申请
淘宝客-推广者-种草商单子任务改价结果查询
淘宝客-推广者-厂商版加密用户标识获取
淘宝客-推广者-内容种草投流对账单
商业化消息推送
淘宝客-推广者-厂商版-个性化推荐商品获取
淘宝客-推广者-内容三方万能转链
通用用户监测数据上传
淘宝客-服务商-群信息获取
淘宝客-服务商-社群创建
淘宝客-服务商-社群删除
淘宝客-服务商-群内人群管理
淘宝客-服务商-加密用户标识生成
获取服务商达人数据
淘宝客_推广者_个性化商品获取
淘宝客_服务商_个性化商品获取
淘宝客-服务商-商品行为上报
淘宝客-推广者-商品行为上报
淘宝客-推广者-万能解析
淘宝客-服务商-万能解析
淘宝-淘宝客-服务商-用户绑定状态查询
淘宝-淘宝客-推广者-用户绑定状态查询
商单种草任务内容信息变更
淘宝客-服务商-自定义服务组成员修改
淘宝客-服务商-自定义服务组成员查询
淘宝客-推广者-UVID人群挑量
淘宝客-服务商-UVID人群挑量
淘宝客-内容三方-媒体数据报表交换-汇总数据
创建社群拉新礼金
环境 | 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_group_id | Number | 可选 | 21312 | member组id | |
tb_num_ids | String | 可选 | 12,3123 | 淘宝数字id |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
data | MapData | 返回结果 | |
|
1 2 3 4 5 6 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); TbkScMembergroupOptionalRequest req = new TbkScMembergroupOptionalRequest(); req.setMemberGroupId(21312L); req.setTbNumIds( "12,3123" ); TbkScMembergroupOptionalResponse rsp = client.execute(req); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 | ITopClient client = new DefaultTopClient(url, appkey, secret); TbkScMembergroupOptionalRequest req = new TbkScMembergroupOptionalRequest(); req.MemberGroupId = 21312L; req.TbNumIds = "12,3123" ; TbkScMembergroupOptionalResponse rsp = client.Execute(req); Console.WriteLine(rsp.Body); |
1 2 3 4 5 6 7 | $c = new TopClient; $c ->appkey = $appkey ; $c ->secretKey = $secret ; $req = new TbkScMembergroupOptionalRequest; $req ->setMemberGroupId( "21312" ); $req ->setTbNumIds( "12,3123" ); $resp = $c ->execute( $req ); |
1 2 3 4 5 6 7 8 9 10 11 12 | -H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \ -d 'app_key=12129701' \ -d 'format=json' \ -d 'method=taobao.tbk.sc.membergroup.optional' \ -d 'partner_id=apidoc' \ -d 'sign=E58DDE3174E3B25EA0C170156D27BADF' \ -d 'sign_method=hmac' \ -d 'timestamp=2025-05-07+02%3A44%3A38' \ -d 'v=2.0' \ -d 'member_group_id=21312' \ -d 'tb_num_ids=12%2C3123' |
1 2 3 4 5 6 7 8 9 10 11 12 13 | # -*- coding: utf-8 -*- import top.api req = top.api.TbkScMembergroupOptionalRequest(url,port) req.set_app_info(top.appinfo(appkey,secret)) req.member_group_id = 21312 req.tb_num_ids = "12,3123" try : resp = req.getResponse() print (resp) except Exception,e: print (e) |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | pTopRequest pRequest = alloc_top_request(); pTopResponse pResponse = NULL; pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret); set_api_name(pRequest, "taobao.tbk.sc.membergroup.optional" ); add_param(pRequest, "member_group_id" , "21312" ); add_param(pRequest, "tb_num_ids" , "12,3123" ); 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); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | TopClient = require( './topClient' ).TopClient; var client = new TopClient({ 'appkey' : 'appkey' , 'appsecret' : 'secret' , }); client.execute( 'taobao.tbk.sc.membergroup.optional' , { 'member_group_id' : '21312' , 'tb_num_ids' : '12,3123' }, function(error, response) { if (!error) console.log(response); else console.log(error); }) |
1 2 3 4 5 6 7 8 | < tbk_sc_membergroup_optional_response > < data > < member_group_id >2123</ member_group_id > < tb_num_ids >21,212</ tb_num_ids > < create_time >1659453134000</ create_time > < update_time >1659453134000</ update_time > </ data > </ tbk_sc_membergroup_optional_response > |
1 2 3 4 5 6 7 8 9 10 | { "tbk_sc_membergroup_optional_response" :{ "data" :{ "member_group_id" :2123, "tb_num_ids" : "21,212" , "create_time" : "1659453134000" , "update_time" : "1659453134000" } } } |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
1 2 3 4 5 6 7 8 | { "error_response" :{ "msg" : "Remote service error" , "code" :50, "sub_msg" : "非法参数" , "sub_code" : "isv.invalid-parameter" } } |
错误码 | 错误描述 | 解决方案 |
---|