淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
点击获取APKEY

正常 权益物料精选

更新时间:2020-11-13 14:41:58

请求链接: http://api.web.ecapi.cn/taoke/getPromotionItem
请求实例: http://api.web.ecapi.cn/taoke/getPromotionItem?apkey=登录会员中心查看&tbname=xxxx&pid=mm_123456_456789_789132&promotion_id=37116 (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
会员限制: 付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 支持入参推广者对应的“推广位”和官方提供的“权益物料id”,获取指定权益物料。
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
tbnameStringxxxx在本平台授权的淘宝用户名
pidStringmm_123456_456789_789132授权联盟账号下的PID
promotion_idString37116官方提供的权益物料Id。有价券-37104、大额店铺券-37116,更多权益物料id敬请期待!
pagenoNumber1页码
pagesizeNumber10页大小,每次请求限制10以内

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据列表
 ├ promotion_typeString权益类型1 有价券(需要购买的店铺券或单品券) 2 公开券(直接领取的店铺券或单品券) 3 妈妈券(妈妈渠道领取的店铺券或单品券) 4.品类券 (跨店可用券,可与1,2,3叠加)
 ├ condition_typeString优惠门槛类型1 满元 2 满件
 ├ discount_typeString优惠类型1 减钱 2 打折
 ├ total_countNumber权益信息-总量(权益初始库存量)
 ├ remain_countNumber权益信息-剩余库存(权益剩余库存量)
 ├ display_start_timeString权益信息展示开始时间精确到毫秒时间戳
 ├ display_end_timeString权益信息展示结束时间精确到毫秒时间戳
 ├ promotion_listJson权益信息
 ├  ├ entry_used_start_timeString权益开始时间精确到毫秒时间戳
 ├  ├ entry_used_end_timeString权益结束时间精确到毫秒时间戳
 ├  ├ entry_conditionString权益起用门槛,满X元可用,券场景为满元,精确到分,如满100元可用
 ├  ├ entry_discountString权益面额,券场景为减钱,精确到分
 ├ promotion_extendJson权益扩展信息
 ├  ├ promotion_urlString权益链接
 ├  ├ recommend_item_listJson权益推荐商品
 ├  ├  ├ item_idString权益推荐商品id
 ├  ├  ├ urlString商品链接
 ├  ├ youjia_coupon_infoJson有价券信息
 ├  ├  ├ item_idString有价券商品id
 ├  ├  ├ urlString商品链接
 ├ seller_idString店铺信息-卖家ID
 ├ nickString店铺信息-卖家昵称
 ├ shop_titleString店铺信息-店铺名称
 ├ shop_picture_urlString店铺信息-店铺logo

Json返回示例

{"code":200,"data":[{"condition_type":"1","discount_type":"1","display_end_time":"1605283198000","display_start_time":"1603100608000","nick":"弹个车汽车旗舰店","promotion_extend":{"recommend_item_list":{"recommend_item_list":[{"item_id":623211801839,"url":"//s.click.taobao.com/t?e=m=2&s=lSkuVKFGaZBw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0PRvvWF4CrrJm67EsvnBWhd5AXfiWajJ7kM7/x4T0IGLoZWj9sofm/fxDhneUlf29l9EeTtntI44hla2gak2AfZ1NMTHQ3EBVhZGFUMx/5aNix2rZGrcBzRdZenpXO14+KTYXD9JbF7iz2TFFEd9SqY="}]},"youjia_coupon_info":{"item_id":"629831997574","url":"//s.click.taobao.com/t?e=m=2&s=PlVB3VKreL1w4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0PRvvWF4CrrJm67EsvnBWhd5AXfiWajJ7kM7/x4T0IGLoZWj9sofm/fxDhneUlf29l9EeTtntI44hla2gak2AfZ1NMTHQ3EBVhZGFUMx/5aN8yHQr2I2x9sgr+ySxG8GiaTYXD9JbF7iz2TFFEd9SqY="}},"promotion_list":{"promotion_list":[{"entry_condition":"3001","entry_discount":"3000","entry_used_end_time":"1605283199000","entry_used_start_time":"1603123200000"}]},"promotion_type":"有价券","remain_count":2977,"seller_id":"3001593287","shop_picture_url":"https://img.alicdn.com/c5/df/TB1XyPMkcbpK1RjSZFywu0_qFXa.png","shop_title":"弹个车汽车旗舰店","total_count":3000}],"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对