接口提交物料介绍

物料提交接口

接口说明:接口调用者需要记录物料 id 和 path 信息。进行物料修改和删除时物料 id 和物料 path 信息为必填字段 。
普通开发者接口地址

  1. https://openapi.baidu.com/rest/2.0/smartapp/articlemount/material/add

TP 调用地址

  1. https://openapi.baidu.com/rest/2.0/smartapp/articlemount/material/tp/add

请求方式: POST

接口参数:

字段类型是否必填说明
access_tokenString权限校验 Token 获取方式见:https://smartprogram.baidu.com/docs/develop/server/power/#开发者服务权限说明 tp 调用需要有小程序推广能力权限
app_idInt参数举例:1000001
imageUrlString小图片地址,长度不能超过 500 个字符,最小尺寸为 213213,比例为 1:1,单图最大为 2M
titleString标题,需要描述完整,能够明确表示小程序或内容的主要信息点,不能全英文,6-30 个字。若选择相应垂类时,此字段只作为兜底展示字段示例: 超经典的蔓越莓曲奇饼干,在家也能做
pathString智能小程序内页链接 ,示例: /pages/index/index
category1CodeString一级分类字段,取值见 下表: (分类字段说明)
category2CodeString二级分类字段,取值见下表:(分类字段说明)
descString4-17 个汉字。标题解释说明; 示例: 修复半年若爆胎换新轮胎,低价保真
labelAttrString属性、特点。最多三个标签;每个标签字数不超过 5 个汉字,多个使用因为 / 隔开 示例:可上楼 / 全国覆盖
labelDiscountString优惠信息,最多一个标签;每个标签字数不超过 7 个汉字 示例:首次免费
buttonNameString按钮文案,最多 4 个字 示例:特惠购票
bigImageString封面图片链接(1 张,单图片最大 2M)大图模板要求最小尺寸 1068 x 601,比例为 16:9,单图最大为 2M 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
verticalImageString当选择小说/动漫,影视剧,电影票务,演出赛事时必填;(竖图 3:4)最低 213284 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
extJsonString扩展信息(JSON 格式,参考下方各个分类扩展字段说明)

接口返回值

  1. {
  2. "errno": 0,
  3. "msg": "success",
  4. "data": {
  5. "path": "/page/index",
  6. "id": 10120
  7. }
  8. }

返回字段说明

path //小程序落地页 path 地址 id //物料唯一 id

物料修改接口

接口说明: 物料 id 和 path 必填,而且 path 字段不能修改
接口地址https://openapi.baidu.com/rest/2.0/smartapp/articlemount/material/modify
请求方式 : POST

接口参数:

字段类型是否必填说明
access_tokenString权限校验 Token 获取方式见:https://smartprogram.baidu.com/docs/develop/server/power/#开发者服务权限说明
app_idInt参数举例:1000001
idLong物料 id ,添加物料时返回 id
imageUrlString小图片地址,长度不能超过 500 个字符,最小尺寸为 213213,比例为 1:1,单图最大为 2M
titleString标题,需要描述完整,能够明确表示小程序或内容的主要信息点,不能全英文,6-30 个字。若选择相应垂类时,此字段只作为兜底展示字段示例: 超经典的蔓越莓曲奇饼干,在家也能做
pathString智能小程序内页链接 ,示例: /pages/index/index
category1CodeString一级分类字段,取值见 下表: (分类字段说明)
category2CodeString二级分类字段,取值见下表:(分类字段说明)
descString4-17 个汉字。标题解释说明; 示例: 修复半年若爆胎换新轮胎,低价保真
labelAttrString属性、特点。最多三个标签;每个标签字数不超过 5 个汉字,多个使用因为 / 隔开 示例:可上楼 / 全国覆盖
labelDiscountString优惠信息,最多一个标签;每个标签字数不超过 5 个汉字 示例:首次免费
buttonNameString按钮文案,最多 4 个字 示例:特惠购票
bigImageString封面图片链接(1 张,单图片最大 2M)大图模板要求最小尺寸 1068 x 601,比例为 16:9,单图最大为 2M 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
verticalImageString当选择小说/动漫,影视剧,电影票务,演出赛事时必填;(竖图 3:4)最低 213284 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
extJsonString扩展信息(JSON 格式,参考下方各个分类扩展字段说明)

接口返回值:

  1. {
  2. "errno": 0,
  3. "msg": "success",
  4. // 返回true 代表修改成功,false:代码修改失败
  5. "data": true
  6. }

物料删除接口

接口说明 : 删除物料,id 和 path 为必传
接口地址 : https://openapi.baidu.com/rest/2.0/smartapp/articlemount/material/delete
请求方式 : POST

接口参数:

字段类型是否必填说明
access_tokenString权限校验 Token 获取方式见:https://smartprogram.baidu.com/docs/develop/server/power/#开发者服务权限说明
app_idInt参数举例:1000001
idLong物料 id ,添加物料时返回 id
pathString智能小程序内页链接 ,取值为添加物料时返回的 path ,示例: /pages/index/index,

接口返回值:

  1. { "errno": 0,
  2. "msg": "success",
  3. // true成功,false: 失败
  4. "data": true
  5. }

各个分类扩展字段说明

内容->小说/动漫

字段名称字段类型是否必填字段说明
authorNameString作者名 示例:夜语轻寒
introductionString简介说明,最少 17 个字 示例: 从前有座山,山里住着一群善良的农民
nameString小说名 示例: 制霸全球
statusInt小说状态,0:连载中;1:已完结 示例 1
typeString分类,多个用斜线分隔 示例: 都市异能/玄幻

内容->影视剧

字段名称字段类型是否必填字段说明
actorsString主演,如动漫无主演可不填,多个用斜线分隔 示例: 朱一龙/白宇
nameString电视剧名 示例:镇魂
typeString分类,多个用斜线分隔 示例: 都市/爱情/网剧
updateInfoString更新情况,示例:共 45 集

到店->电影

字段名称字段类型是否必填字段说明
nameString电影名 示例:千与千寻
likeNumInt想看人数 示例:847638
countryString电影所属国家 示例:美国
filmDurationString电影时长 示例:104 分钟
typeString电影分类,多个用斜杠隔开 示例:奇幻/喜剧
actorsString主演,多个用斜杠隔开 示例:彭昱畅/周冬雨
movieReleaseTimeString电影上映时间 示例:2018-09-08
scoreString电影评分,当电影未上映是可不填 示例:8.4
couponIDString优惠券类型,跟卡券中心的 couponID 保持一致 示例:111

到店->演出赛事

字段名称字段类型是否必填字段说明
couponIDString优惠券类型,跟卡券中心的 couponID 保持一致 示例:111
locationString演出地点,必须写清城市和具体地址 示例:重庆市人民大礼堂
nameString演出名 示例:2019 德云社龄龙相声专场 重庆站
priceString价格 示例:199 起
timeString演出时间 示例:2019-11-02 周六 19:30

到店->美食

字段名称字段类型是否必填字段说明
nameString商铺名称 示例:西贝莜面村
locationString商铺地理位置信息(具体到城市) 示例:北京西城区
categoryString商铺所属分类 示例:日料
scoreString商铺星级,十分制 示例:8.3
priceString人均价格 示例:200

电商->综合

字段名称字段类型是否必填字段说明
nameString商品名称 示例:Apple Iphone X
priceString价格 示例:7099
category1String商品类别(一级) 示例:电子产品
favorableRateString好评率 示例:99%
category2String商品类别(二级) 示例:通讯
category3String商品类别(三级) 示例:手机
brandString品牌 示例:Apple
modelString型号 示例:(A1865) 64GB
couponIDString优惠券类型,跟卡券中心的 couponID 保持一致 示例:111

旅游出行->酒店

字段名称字段类型是否必填字段说明
nameString酒店名称 示例:如家前门店
locationString酒店地理位置信息(具体到城市) 示例:北京西城区
scoreString酒店评分 示例:9.6
priceString价格 示例:468 元起
starLevelString酒店星级 示例:经济型酒店

旅游出行->景点门票

字段名称字段类型是否必填字段说明
nameString景点名称 示例:故宫
locationString景点地理位置信息(具体到城市) 示例:北京市东城区
scoreString景点评分 示例:9.6
priceString价格 示例:60 元

车主->汽车估值

字段名称字段类型是否必填字段说明
modelString车系 示例:奥迪 Q3 2019 款
priceString报价 示例:26.46 万-50 万
brandString品牌 示例:奥迪

房产->综合

字段名称字段类型是否必填字段说明
nameString小区或者楼盘名称 示例:融泽家园
priceString售卖/出租价格 示例:199 万
locationString地址,必须写清城市和具体地址 示例:重庆市人民大礼堂
squareString面积 示例:98m²

通用->其他

分类字段说明

序号分类名称分类编码父级分类编码
1内容10
2到店20
3电商30
4旅游出行40
5车主50
6房产60
7通用70
8小说/动漫100011
9影视剧100021
10电影200012
11演出赛事200022
12美食200032
13综合300013
14酒店400014
15景点门票400024
16汽车估值500015
17综合600016
18其他700017