权益物料精选API接口

接口地址：http://bkapi.com/api/PromotionItem

返回格式：json

请求方式：get

请求示例：http://bkapi.com/api/PromotionItem?appkey=登录个人中心查看&tbname=xxxxx&pid=mm_xxxx_xxx_xxx&promotion_id=37116

请求方法

参数	是否必须	参数类型	说明
appkey	必填	String	登录后个人中心查看
tbname	必填	String	淘客账号所对应的用户名,见“个人中心”-“淘宝授权”
pid	必填	int	推广位PID（*必须是授权淘宝号下的推广位）
promotion_id	int	String	官方提供的权益物料Id。有价券-37104、大额店铺券-37116、天猫店铺券-62191、券券补-61809 更多权益物料id敬请期待！
page_num	否	int	第几页，默认：1
page_size	否	int	页大小，每次请求限制10以内

响应参数：

参数	类型	示例值	说明
result_list	MapData []		resultList
├ promotion_type	String	1	权益类型。1 有价券（需要购买的店铺券或单品券） 2 公开券（直接领取的店铺券或单品券） 3 妈妈券（妈妈渠道领取的店铺券或单品券） 4.品类券（跨店可用券，可与1，2，3叠加）
├ condition_type	String	1	优惠门槛类型： 1 满元 2 满件
├ discount_type	String	1	优惠类型： 1 减钱 2 打折
├ total_count	Number	50	权益信息-总量（权益初始库存量）
├ remain_count	Number	20	权益信息-剩余库存（权益剩余库存量）
├ display_start_time	String	1.55923E+12	权益信息展示开始时间，精确到毫秒时间戳
├ display_end_time	String	1.55975E+12	权益信息展示结束时间，精确到毫秒时间戳
promotion_list	PromotionList[]		权益信息
├ entry_used_start_time	String	1.55923E+12	权益开始时间，精确到毫秒时间戳
├ entry_used_end_time	String	1.55975E+12	权益结束时间，精确到毫秒时间戳
├ entry_condition	String	100	权益起用门槛，满X元可用，券场景为满元，精确到分，如满100元可用
├ entry_discount	String	30	权益面额，券场景为减钱，精确到分
promotion_extend	PromotionExtend		权益扩展信息
├ recommend_item_list	RecommendItemList[]		权益推荐商品
├ ├ item_id	Number	123456	权益推荐商品id
├ ├ url	String	//s.click.taobao.com/xxx	商品链接
├ youjia_coupon_info	Youjiacouponinfo		有价券信息
├ ├ item_id	String	123456	有价券商品id
├ ├ url	String	//s.click.taobao.com/xxx	商品链接
├ promotion_url	String	https://uland.taobao.com/quan/xxx	权益链接
├ seller_id	String	123	店铺信息-卖家ID
├ nick	String	XXX专营店	店铺信息-卖家昵称
├ shop_title	String	XXX旗舰店	店铺信息-店铺名称
├ shop_picture_url	String	图片url	店铺信息-店铺logo

响应示例

                                                       
                    
{
  "result_list": [
    {
      "condition_type": "1",
      "discount_type": "1",
      "display_end_time": "1751212799000",
      "display_start_time": "1746028800000",
      "nick": "华帝厨卫旗舰店",
      "promotion_extend": {
        "promotion_url": "https://taoquan.taobao.com/coupon/unify_apply.htm?sellerId=1743125211&activityId=8733cbebc24f450da517e3e55c789698",
        "recommend_item_list": [
          {
            "item_id": 592471401458,
            "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DmGGZkZjuoJVw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0CYPoy8haG6xJ%2BaUN0%2FL9qFDRcdYvJb1nctn55kP8BVOnFsTIDsiqIhkXqY608UPyaCayAaJqUfiZiqtwk9j5QNerBM5mSXVLasl2Gtg3m9eYQ3THCwZ1WEB%2BzpSbu%2Fbksw4dvoMT2leaSsxU%2FPJB6i0DyGLDdqFfVO%2BIEeAR1wcS9qz8foCUmY5H1S63Uo%2FiQRGrIzNnGtly%2FDBex4JP5LS%2FmAhDsspacYOae24fhW0"
          },
          {
            "item_id": 600835241094,
            "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DTG9B95HJERZw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0CYPoy8haG6xJ%2BaUN0%2FL9qFDRcdYvJb1nctn55kP8BVOnFsTIDsiqIhkXqY608UPyaCayAaJqUfiZiqtwk9j5QNerBM5mSXVLasl2Gtg3m9eYQ3THCwZ1WEClpzPQbjBrFZsgzf2GQhqDUiJRAeTwAw%2BLdIToe7amWvd7XGdmg5yfNI1by7FDgnuoA0gAS4S6CTd%2F155caTkVs3644XDpinGDF1NzTQoPw%3D%3D"
          },
          {
            "item_id": 640183916319,
            "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DMKdZYDIO0Zpw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0CYPoy8haG6xJ%2BaUN0%2FL9qFDRcdYvJb1nctn55kP8BVOnFsTIDsiqIhkXqY608UPyaCayAaJqUfiZiqtwk9j5QNerBM5mSXVLasl2Gtg3m9eYQ3THCwZ1WE%2BZauTxmjYTiSTgsev40WBJ9jwlDBpnhbBndTyxUF7S4BYLjY8ddBXdtbzVXuPbG1QutzRJgCuB2N7lwx0Z3MXr%2FPo1Ata%2FJ4Mlu5kMKse3g%3D%3D"
          },
          {
            "item_id": 779880719552,
            "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DBQ18UBRK6WZw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0CYPoy8haG6xJ%2BaUN0%2FL9qFDRcdYvJb1nctn55kP8BVOnFsTIDsiqIhkXqY608UPyaCayAaJqUfiZiqtwk9j5QNerBM5mSXVLasl2Gtg3m9eYQ3THCwZ1WEjAXqTT1Am9m3taFoVRMJ9MKvIZsDTGEt%2BWjW7onLtygE0ohsu1kXtiEOF51%2BoQUfiLCi9t%2F9MTKVg5%2BXa%2BOGFr%2FPo1Ata%2FJ4Mlu5kMKse3g%3D%3D"
          },
          {
            "item_id": 669076765908,
            "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DLWBQtN%2FcMLJw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0CYPoy8haG6xJ%2BaUN0%2FL9qFDRcdYvJb1nctn55kP8BVOnFsTIDsiqIhkXqY608UPyaCayAaJqUfiZiqtwk9j5QNerBM5mSXVLasl2Gtg3m9eYQ3THCwZ1WFwST53lZqqC1aUtgjXEBuh7mu0tUnJTa8oZAufjZjnQ0%2F9hZk8RZ9xuPOYwLzz9JUmbH1OyAjWzAngfZh64DPKBMQqQ%2FYQtHZ01v8HssJqISGFCzYOOqAQ"
          }
        ]
      },
      "promotion_list": [
        {
          "entry_condition": "201",
          "entry_discount": "200",
          "entry_used_end_time": "1751212799000",
          "entry_used_start_time": "1746028800000"
        }
      ],
      "promotion_type": "公开券",
      "remain_count": 75000,
      "seller_id": "4658060126933055035",
      "shop_picture_url": "https://img.alicdn.com/imgextra/i2/1743125211/O1CN01XRKgYS1oMgmXlKk84_!!1743125211-0-shopmanager.jpg",
      "shop_title": "华帝厨卫旗舰店",
      "total_count": 100000
    }
  ]
}

code说明

code	说明
50001	无结果
40001	内部调用失败
50	系统异常