正常权益物料精选接口在线测试

支持入参推广者对应的“推广位”和官方提供的“权益物料id”，获取指定权益物料。

接口地址： 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编码，然后再试。

请求方式：GET

会员范围：付费会员 (新用户注册立刻送7天V1付费会员【注：赠送会员可使用全部接口，但调用频率与免费会员一致，免费会员调用频率可参考会员等级说明】)

必看注意：为保障接口安全及使用效率，调用本站接口前需先添加IP白名单 (IP地址测试)，若IP不固定且无服务器，可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口，禁止将接口重新打包销售或转卖，一经发现，将做帐号封禁处理。

优惠推荐：高性能云服务器2折起，普惠上云，仅需234元/年 ->>立即抢购<<- 。

使用说明: 暂无说明

请求参数

参数	类型	请求参数参考值	是否必须	说明
apkey	String	xxxxxxx	是	用户中心 - 系统设置 - 平台设置中查看APKEY密钥 (点我获取)（*必要）
tbname	String	xxxx	是	在本平台授权的淘宝用户名
pid	String	mm_123456_456789_789132	是	授权联盟账号下的PID（注：如已在会员中心设置了默认PID，此参数可无需再次传入）
promotion_id	String	37116	是	官方提供的权益物料Id。有价券-37104、大额店铺券-37116、天猫店铺券-62191、券券补-61809 更多权益物料id敬请期待！
pageno	Number	1		页码
pagesize	Number	10		页大小，每次请求限制10以内

返回参数

返回参数	类型	参数说明	扩展说明
data	Json	返回数据列表
├　promotion_type	String	权益类型	1 有价券（需要购买的店铺券或单品券） 2 公开券（直接领取的店铺券或单品券） 3 妈妈券（妈妈渠道领取的店铺券或单品券） 4.品类券（跨店可用券，可与1，2，3叠加）
├　condition_type	String	优惠门槛类型	1 满元 2 满件
├　discount_type	String	优惠类型	1 减钱 2 打折
├　total_count	Number	权益信息-总量（权益初始库存量）
├　remain_count	Number	权益信息-剩余库存（权益剩余库存量）
├　display_start_time	String	权益信息展示开始时间	精确到毫秒时间戳
├　display_end_time	String	权益信息展示结束时间	精确到毫秒时间戳
├　promotion_list	Json	权益信息
├　　├　entry_used_start_time	String	权益开始时间	精确到毫秒时间戳
├　　├　entry_used_end_time	String	权益结束时间	精确到毫秒时间戳
├　　├　entry_condition	String	权益起用门槛，满X元可用，券场景为满元，精确到分，如满100元可用
├　　├　entry_discount	String	权益面额，券场景为减钱，精确到分
├　promotion_extend	Json	权益扩展信息
├　　├　promotion_url	String	权益链接
├　　├　recommend_item_list	Json	权益推荐商品
├　　├　　├　item_id	String	权益推荐商品id
├　　├　　├　url	String	商品链接
├　　├　youjia_coupon_info	Json	有价券信息
├　　├　　├　item_id	String	有价券商品id
├　　├　　├　url	String	商品链接
├　seller_id	String	店铺信息-卖家ID
├　nick	String	店铺信息-卖家昵称
├　shop_title	String	店铺信息-店铺名称
├　shop_picture_url	String	店铺信息-店铺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	数据获取失败
401	IP没有添加白名单
429	访问次数超限
403	关键参数丢失
405	请求方式不对