优惠券资源提交介绍

1. 优惠券资源说明

优惠券资源是指小程序优惠券数据的统一物料管理库,开发者提交后会在服务中心天天抽红包活动落地页进行分发,后续更多分发场景正在设计中,已在规划中的分发场景有搜索品牌词、私信、信息流-关注频道等。

备注:
1、优惠券资源库只接收优惠券数据。
2、当前优惠券资源库仅为邀请制(结合小程序服务闭环体验整体评估),暂未开放申请,感谢关注,敬请期待。

2. 优惠券资源提交接口

解释:提交/修改资源接口,API 实时接口提交方式。

若有资源在小程序内需要提交或资源推送错误需要修改(或更新)的情况,请调用该接口进行优惠券资源的提交,每次最多提交 50 个优惠券。

  1. POST https://openapi.baidu.com/rest/2.0/smartapp/server/submit/skuCoupon

公共请求参数

参数类型是否必填描述示例值
access_tokenString小程序权限校验 Token

请求方式说明:请 POST 方式提交,且设置 header[‘content-type’] 为 application/json 。

body 请求参数

  1. [
  2. {
  3. "region": "黑龙江省-哈尔滨市",
  4. "schema": "{\"collect_coupon_begin_time\":\"2020-10-18 12:12:12\",\"collect_coupon_end_time\":\"2021-02-02 12:12:12\",\"coupon_stock\":\"12\",\"coupon_type\":\"PER_FULL_CUT_MONEY\",\"coupon_use_rule\":\"100\",\"coupon_use_time\":\"12\",\"coupon_value\":\"11\"}",
  5. "title": "不同类目1007",
  6. "desc": "优惠券描述",
  7. "path": "/test/test/coupon000121",
  8. "trade_type": 1003
  9. }
  10. ]

请求参数字段说明

参数类型是否必填描述示例值
pathString智能小程序落地页链接/pages/detail/detail?id=100001
titleString优惠券标题:活动优惠信息说明,12-24 个字符(汉字占 2 字符);不允许有特殊符号;优惠活动信息必须真实星巴克 5 元代金券
trade_typeint服务类目编码(参考附录一1001
descString优惠券简介,优惠券的文字解释说明,8~34 个字符(汉字占 2 字符)优惠券描述
regionString服务地域,省市之间用英文中划线分割,多个地区之间用英文逗号分割示例 1:四川省-成都市,天津市
示例 2:全国
schemastring优惠券的具体信息,详见:coupon_info

coupon_info 对象字段说明

参数类型是否必填描述示例值
collect_coupon_begin_timeString优惠券可领取的开始时间,开始时间最多早于提交时间 180 个自然日,精确到日;格式要求:年-月-日 时:分:秒2020-02-02 23:59:59
collect_coupon_end_timeString优惠券发放结束时间不早于优惠券发放开始时间且不早于提交时间;精确到日;格式要求:年-月-日 时:分:秒2020-03-02 23:59:59
coupon_typeString类型 1:满减折扣券(PER_FULL_CUT_DISCOUNT);类型 2:满减金额券(PER_FULL_CUT_MONEY)PER_FULL_CUT_MONEY
coupon_use_ruleString优惠券使用条件:数值,最多保留小数点后两位,例如满 100 元可用,填写金额 100;无门槛填写 0.01100
coupon_valueString选择满减折扣券:满减折扣券,输入打折数值,最多保留小数点后一位,例如 5.5(折),填写 5.5,单位(折)不用填写;选择满减金额券:满减金额券,输入满减金额,例如 5(元),填写5,单位(元)不用填写5.5
coupon_stockString活动优惠库存量:true 表示有库存,false 表示无库存,该条物料传 false 时会被下线true
coupon_use_timeString优惠券领取后可使用的时间范围:1、时间格式:开始时间不晚于可领取的开始时间,结束时间不早于可领取的结束时间;格式要求:年-月-日 时:分:秒-年-月-日 时:分:秒;2、领取后有效时间:领取后 N 天内有效领取后 30 天内有效

返回字段说明

参数类型描述示例值
errnoInt状态码40001
msgString状态描述参数错误
dataString响应参数(如有提交失败的数据会返回失败的 path 和原因)

请求示例

  1. curl -X POST \
  2. 'https://openapi.baidu.com/rest/2.0/smartapp/server/submit/sku?access_token=24.caba1534f826f164e61f142c642eca98.2592000.1595905348.282335-1788089' \
  3. -H 'Content-Type: application/json' \
  4. -d '[
  5. {
  6. "region": "黑龙江省-哈尔滨市",
  7. "schema": "{\"collect_coupon_begin_time\":\"2020-10-18 12:12:12\",\"collect_coupon_end_time\":\"2021-02-02 12:12:12\",\"coupon_stock\":\"12\",\"coupon_type\":\"PER_FULL_CUT_MONEY\",\"coupon_use_rule\":\"100\",\"coupon_use_time\":\"12\",\"coupon_value\":\"11\"}",
  8. "title": "不同类目1007",
  9. "desc": "优惠券描述",
  10. "path": "/test/test/coupon000121",
  11. "trade_type": 1003
  12. }
  13. ]'

返回值示例

  1. {
  2.   "errno":0,
  3.   "msg":"success",
  4.   "data":"{\"/pages/detail/detail?id=100001\":\"审核中资源禁止更新\"}"
  5. }

附录一:服务类目

编码类型二级类型二级类型简称
1001到店电影电影
1002到店演出赛事演出赛事
1003到店休闲娱乐(ktv/密室/按摩等)休闲娱乐
1004到店美食美食
1005到店亲子乐园亲子乐园
1006到店丽人丽人
1007到店美发美发
2001电商书籍书籍
2002电商服装佩饰服装佩饰
2003电商食品酒饮食品酒饮
2004电商生鲜生鲜
2005电商数码家电数码家电
2006电商母婴母婴
2007电商家居生活家居生活
2008电商美妆美妆
2009电商个护清洁个护清洁
2010电商奢侈品奢侈品
2011电商宠物用品宠物用品
2012电商综合(优惠券专用)综合(优惠券专用)
3001充值缴费手机运营商服务手机运营商服务
3002充值缴费水电煤缴费水电煤缴费
3003充值缴费固话宽带固话宽带
3004充值缴费物业费物业费
4001投资理财信用卡业务信用卡业务
4002投资理财银行卡业务银行卡业务
4003投资理财保险保险
4004投资理财贷款贷款
5001旅游出行酒店酒店
5002旅游出行出行票务(飞机/火车/汽车/轮船等)出行票务
5003旅游出行景点门票景点门票
5004旅游出行线路游线路游
5005旅游出行签证签证
5006旅游出行租车租车
5007旅游出行打车打车
5008旅游出行值机值机
6001上门服务外卖外卖
6002上门服务拉货搬家拉货搬家
6003上门服务手机维修手机维修
6004上门服务电脑维修电脑维修
6005上门服务耳机维修耳机维修
6006上门服务手表维修手表维修
6007上门服务手机维修手机维修
6008上门服务家电维修家电维修
6009上门服务房屋维修房屋维修
6010上门服务家电清洗家电清洗
6011上门服务开锁换锁开锁换锁
6012上门服务管道疏通管道疏通
6013上门服务家政保洁家政保洁
6014上门服务上门回收上门回收
6015上门服务衣物洗护衣物洗护
6016上门服务改衣服务改衣服务
6017上门服务安装调试安装调试
6018上门服务美甲美容美甲美容
7001房产新房新房
7002房产二手房二手房
7003房产房屋租赁房屋租赁
7004房产装修装修
8001快递同城直送同城直送
8002快递上门取件上门取件
8003快递国际快递国际快递
9001医疗医生咨询医生咨询
9002医疗挂号挂号
9003医疗买药买药
9004医疗医美医美
9005医疗宠医宠医
10001法律法律咨询法律咨询
10002法律合同文书服务合同文书服务
10003法律律师函服务律师函服务
11001教育课程培训课程培训
11002教育教育咨询教育咨询
11003教育校园生活校园生活
12001招聘兼职招聘兼职招聘
12002招聘全职招聘全职招聘
12003招聘校园招聘校园招聘
13001车主汽车估值汽车估值
13002车主代驾代驾
13003车主交管服务(摇号/违章/驾照查分等)交管服务
13004车主维修保养维修保养
13005车主加油加油
13006车主停车停车
13007车主汽车用品汽车用品
13008车主etcetc

如需新增服务类目发邮件至 ext_service_category@baidu.com ,邮件正文请提供 APP key 、小程序名称、页面标题、描述、落地页 path 、新增类目(一级 & 二级)

附录二:服务地域

全国
上海市上海市
云南省临沧市
云南省丽江市
云南省保山市
云南省昆明市
云南省昭通市
云南省普洱市
云南省曲靖市
云南省玉溪市
北京市北京市
吉林省吉林市
吉林省四平市
吉林省松原市
吉林省白城市
吉林省白山市
吉林省辽源市
吉林省通化市
吉林省长春市
四川省乐山市
四川省内江市
四川省南充市
四川省宜宾市
四川省巴中市
四川省广元市
四川省广安市
四川省德阳市
四川省成都市
四川省泸州市
四川省眉山市
四川省绵阳市
四川省自贡市
四川省资阳市
四川省达州市
四川省遂宁市
四川省雅安市
天津市天津市
安徽省亳州市
安徽省六安市
安徽省合肥市
安徽省安庆市
安徽省宣城市
安徽省宿州市
安徽省池州市
安徽省淮北市
安徽省淮南市
安徽省滁州市
安徽省芜湖市
安徽省蚌埠市
安徽省铜陵市
安徽省阜阳市
安徽省黄山市
山东省东营市
山东省临沂市
山东省威海市
山东省德州市
山东省日照市
山东省枣庄市
山东省泰安市
山东省济南市
山东省济宁市
山东省淄博市
山东省滨州市
山东省潍坊市
山东省烟台市
山东省聊城市
山东省莱芜市
山东省菏泽市
山东省青岛市
山西省临汾市
山西省吕梁市
山西省大同市
山西省太原市
山西省忻州市
山西省晋中市
山西省晋城市
山西省朔州市
山西省运城市
山西省长治市
山西省阳泉市
广东省东莞市
广东省中山市
广东省云浮市
广东省佛山市
广东省广州市
广东省惠州市
广东省揭阳市
广东省梅州市
广东省汕头市
广东省汕尾市
广东省江门市
广东省河源市
广东省深圳市
广东省清远市
广东省湛江市
广东省潮州市
广东省珠海市
广东省肇庆市
广东省茂名市
广东省阳江市
广东省韶关市
江苏省南京市
江苏省南通市
江苏省宿迁市
江苏省常州市
江苏省徐州市
江苏省扬州市
江苏省无锡市
江苏省泰州市
江苏省淮安市
江苏省盐城市
江苏省苏州市
江苏省镇江市
江西省上饶市
江西省九江市
江西省南昌市
江西省吉安市
江西省宜春市
江西省抚州市
江西省新余市
江西省萍乡市
江西省赣州市
江西省鹰潭市
河北省保定市
河北省唐山市
河北省廊坊市
河北省承德市
河北省沧州市
河北省衡水市
河北省邢台市
河北省邯郸市
河南省信阳市
河南省南阳市
河南省周口市
河南省商丘市
河南省安阳市
河南省开封市
河南省新乡市
河南省洛阳市
河南省济源市
河南省漯河市
河南省濮阳市
河南省焦作市
河南省许昌市
河南省郑州市
河南省鹤壁市
浙江省丽水市
浙江省台州市
浙江省嘉兴市
浙江省宁波市
浙江省杭州市
浙江省温州市
浙江省湖州市
浙江省绍兴市
浙江省舟山市
浙江省衢州市
浙江省金华市
海南省三亚市
海南省海口市
湖北省十堰市
湖北省咸宁市
湖北省孝感市
湖北省宜昌市
湖北省武汉市
湖北省荆州市
湖北省荆门市
湖北省襄樊市
湖北省鄂州市
湖北省随州市
湖北省黄冈市
湖北省黄石市
湖南省娄底市
湖南省岳阳市
湖南省常德市
湖南省怀化市
湖南省株洲市
湖南省永州市
湖南省湘潭市
湖南省益阳市
湖南省衡阳市
湖南省邵阳市
湖南省郴州市
湖南省长沙市
甘肃省兰州市
甘肃省天水市
甘肃省定西市
甘肃省平凉市
甘肃省庆阳市
甘肃省张掖市
甘肃省武威市
甘肃省白银市
甘肃省酒泉市
甘肃省金昌市
甘肃省陇南市
福建省三明市
福建省南平市
福建省厦门市
福建省宁德市
福建省泉州市
福建省漳州市
福建省福州市
福建省莆田市
福建省龙岩市
贵州省安顺市
贵州省贵阳市
贵州省遵义市
辽宁省丹东市
辽宁省大连市
辽宁省抚顺市
辽宁省朝阳市
辽宁省本溪市
辽宁省沈阳市
辽宁省盘锦市
辽宁省营口市
辽宁省辽阳市
辽宁省铁岭市
辽宁省锦州市
辽宁省阜新市
辽宁省鞍山市
重庆市重庆市
陕西省咸阳市
陕西省商洛市
陕西省安康市
陕西省宝鸡市
陕西省延安市
陕西省杨陵区
陕西省榆林市
陕西省汉中市
陕西省渭南市
陕西省西安市
陕西省铜川市
陕西省韩城市
青海省西宁市
四川省攀枝花市
安徽省马鞍山市
江苏省连云港市
江西省景德镇市
河北省张家口市
河北省石家庄市
河北省秦皇岛市
河南省三门峡市
河南省平顶山市
河南省驻马店市
湖南省张家界市
甘肃省嘉峪关市
贵州省六盘水市
贵州省毕节地区
贵州省铜仁地区
辽宁省葫芦岛市
青海省海东地区
云南省大理白族自治州
云南省楚雄彝族自治州
云南省迪庆藏族自治州
四川省凉山彝族自治州
四川省甘孜藏族自治州
甘肃省临夏回族自治州
甘肃省甘南藏族自治州
青海省果洛藏族自治州
青海省海北藏族自治州
青海省海南藏族自治州
青海省玉树藏族自治州
青海省黄南藏族自治州
云南省怒江傈僳族自治州
吉林省延边朝鲜族自治州
云南省文山壮族苗族自治州
云南省西双版纳傣族自治州
四川省阿坝藏族羌族自治州
海南省省直辖县级行政单位
湖北省省直辖县级行政区划
云南省德宏傣族景颇族自治州
云南省红河哈尼族彝族自治州
湖北省恩施土家族苗族自治州
湖南省湘西土家族苗族自治州
贵州省黔东南苗族侗族自治州
贵州省黔南布依族苗族自治州
青海省海西蒙古族藏族自治州
贵州省黔西南布依族苗族自治州
黑龙江省伊春市
黑龙江省大庆市
黑龙江省绥化市
黑龙江省鸡西市
黑龙江省鹤岗市
黑龙江省黑河市
黑龙江省七台河市
黑龙江省佳木斯市
黑龙江省双鸭山市
黑龙江省哈尔滨市
黑龙江省牡丹江市
黑龙江省齐齐哈尔市
黑龙江省大兴安岭地区
西藏自治区拉萨市
西藏自治区山南地区
西藏自治区昌都地区
西藏自治区林芝地区
西藏自治区那曲地区
西藏自治区阿里地区
西藏自治区日喀则地区
内蒙古自治区乌海市
内蒙古自治区兴安盟
内蒙古自治区包头市
内蒙古自治区赤峰市
内蒙古自治区通辽市
内蒙古自治区阿拉善盟
内蒙古自治区乌兰察布市
内蒙古自治区呼伦贝尔市
内蒙古自治区呼和浩特市
内蒙古自治区巴彦淖尔市
内蒙古自治区鄂尔多斯市
内蒙古自治区锡林郭勒盟
宁夏回族自治区中卫市
宁夏回族自治区吴忠市
宁夏回族自治区固原市
宁夏回族自治区银川市
广西壮族自治区北海市
广西壮族自治区南宁市
广西壮族自治区崇左市
广西壮族自治区来宾市
广西壮族自治区柳州市
广西壮族自治区桂林市
广西壮族自治区梧州市
广西壮族自治区河池市
广西壮族自治区玉林市
广西壮族自治区百色市
广西壮族自治区贵港市
广西壮族自治区贺州市
广西壮族自治区钦州市
宁夏回族自治区石嘴山市
广西壮族自治区防城港市
新疆维吾尔自治区和田地区
新疆维吾尔自治区哈密地区
新疆维吾尔自治区喀什地区
新疆维吾尔自治区塔城地区
新疆维吾尔自治区乌鲁木齐市
新疆维吾尔自治区克拉玛依市
新疆维吾尔自治区吐鲁番地区
新疆维吾尔自治区阿克苏地区
新疆维吾尔自治区阿勒泰地区
新疆维吾尔自治区昌吉回族自治州
新疆维吾尔自治区伊犁哈萨克自治州
新疆维吾尔自治区博尔塔拉蒙古自治州
新疆维吾尔自治区巴音郭楞蒙古自治州
新疆维吾尔自治区克孜勒苏柯尔克孜自治州
新疆维吾尔自治区自治区直辖县级行政单位