百度智能小程序 接口提交物料介紹

2020-09-05 14:47 更新

接口提交物料介紹

物料提交接口

接口說明:接口調(diào)用者需要記錄物料 id 和 path 信息。進行物料修改和刪除時物料 id 和物料 path 信息為必填字段 。普通開發(fā)者接口地址:

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

TP 調(diào)用地址:

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

請求方式: POST

接口參數(shù):

字段類型是否必填說明
access_tokenString權(quán)限校驗 Token 獲取方式見:開發(fā)者服務(wù)權(quán)限說明 tp 調(diào)用需要有小程序推廣能力權(quán)限
app_idInteger參數(shù)舉例:1000001
imageUrlString小圖片地址,長度不能超過 500 個字符,最小尺寸為 213*213,比例為 1:1,單圖最大為 2M
titleString標(biāo)題,需要描述完整,能夠明確表示小程序或內(nèi)容的主要信息點,不能全英文,6-30 個字。若選擇相應(yīng)垂類時,此字段只作為兜底展示字段示例: 超經(jīng)典的蔓越莓曲奇餅干,在家也能做
pathString智能小程序內(nèi)頁鏈接 ,示例: /pages/index/index
category1CodeString一級分類字段,取值見 下表: (分類字段說明)
category2CodeString二級分類字段,取值見下表:(分類字段說明)
descString4-17 個漢字。標(biāo)題解釋說明; 示例: 修復(fù)半年若爆胎換新輪胎,低價保真
labelAttrString屬性、特點。最多三個標(biāo)簽;每個標(biāo)簽字?jǐn)?shù)不超過 5 個漢字,多個使用因為 / 隔開 示例:可上樓 / 全國覆蓋
labelDiscountString優(yōu)惠信息,最多一個標(biāo)簽;每個標(biāo)簽字?jǐn)?shù)不超過 7 個漢字 示例:首次免費
buttonNameString按鈕文案,最多 4 個字 示例:特惠購票
bigImageString封面圖片鏈接(1 張,單圖片最大 2M)大圖模板要求最小尺寸 1068 x 601,比例為 16:9,單圖最大為 2M 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
verticalImageString當(dāng)選擇小說/動漫,影視劇,電影票務(wù),演出賽事時必填;(豎圖 3:4)最低 213*284 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
extJsonString擴展信息(JSON 格式,參考下方各個分類擴展字段說明)

接口返回值

{
    "errno": 0,
    "msg": "success",
    "data": {
                "path": "/page/index",
                "id": 10120
                
            }
 }

返回字段說明:

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

物料修改接口

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

接口參數(shù):

字段類型是否必填說明
access_tokenString權(quán)限校驗 Token 獲取方式見:開發(fā)者服務(wù)權(quán)限說明
app_idInteger參數(shù)舉例:1000001
idLong物料 id ,添加物料時返回 id
imageUrlString小圖片地址,長度不能超過 500 個字符,最小尺寸為 213*213,比例為 1:1,單圖最大為 2M
titleString標(biāo)題,需要描述完整,能夠明確表示小程序或內(nèi)容的主要信息點,不能全英文,6-30 個字。若選擇相應(yīng)垂類時,此字段只作為兜底展示字段示例: 超經(jīng)典的蔓越莓曲奇餅干,在家也能做
pathString智能小程序內(nèi)頁鏈接 ,示例: /pages/index/index
category1CodeString一級分類字段,取值見 下表: (分類字段說明)
category2CodeString二級分類字段,取值見下表:(分類字段說明)
descString4-17 個漢字。標(biāo)題解釋說明; 示例: 修復(fù)半年若爆胎換新輪胎,低價保真
labelAttrString屬性、特點。最多三個標(biāo)簽;每個標(biāo)簽字?jǐn)?shù)不超過 5 個漢字,多個使用因為 / 隔開 示例:可上樓 / 全國覆蓋
labelDiscountString優(yōu)惠信息,最多一個標(biāo)簽;每個標(biāo)簽字?jǐn)?shù)不超過 5 個漢字 示例:首次免費
buttonNameString按鈕文案,最多 4 個字 示例:特惠購票
bigImageString封面圖片鏈接(1 張,單圖片最大 2M)大圖模板要求最小尺寸 1068 x 601,比例為 16:9,單圖最大為 2M 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
verticalImageString當(dāng)選擇小說/動漫,影視劇,電影票務(wù),演出賽事時必填;(豎圖 3:4)最低 213*284 示例:https://b.bdstatic.com/miniapp/resource/image/demo2.png
extJsonString擴展信息(JSON 格式,參考下方各個分類擴展字段說明)

接口返回值:

{
    "errno": 0,
    "msg": "success",
    "data": true // 返回true 代表修改成功,false:代碼修改失敗
}  

物料刪除接口

接口說明 : 刪除物料,id 和 path 為必傳接口地址 : https://openapi.baidu.com/rest/2.0/smartapp/articlemount/material/delete 請求方式 : POST

接口參數(shù):

字段類型是否必填說明
access_tokenString權(quán)限校驗 Token 獲取方式見:https://smartprogram.baidu.com/docs/develop/server/power/#開發(fā)者服務(wù)權(quán)限說明
app_idInteger參數(shù)舉例:1000001
idLong物料 id ,添加物料時返回 id
pathString智能小程序內(nèi)頁鏈接 ,取值為添加物料時返回的 path ,示例: /pages/index/index,

接口返回值:

{   "errno": 0, 
    "msg": "success",  
    "data": true // true成功,false: 失敗
}  

各個分類擴展字段說明

內(nèi)容->小說/動漫

字段名稱字段類型是否必填字段說明
authorNameString作者名 示例:夜語輕寒
introductionString簡介說明,最少 17 個字 示例: 從前有座山,山里住著一群善良的農(nóng)民
nameString小說名 示例: 制霸全球
statusInt小說狀態(tài),0:連載中;1:已完結(jié) 示例 1
typeString分類,多個用斜線分隔 示例: 都市異能/玄幻

內(nèi)容->影視劇

字段名稱字段類型是否必填字段說明
actorsString主演,如動漫無主演可不填,多個用斜線分隔 示例: 朱一龍/白宇
nameString電視劇名 示例:鎮(zhèn)魂
typeString分類,多個用斜線分隔 示例: 都市/愛情/網(wǎng)劇
updateInfoString更新情況,示例:共 45 集

到店->電影

字段名稱字段類型是否必填字段說明
nameString電影名 示例:千與千尋
likeNumInt想看人數(shù) 示例:847638
countryString電影所屬國家 示例:美國
filmDurationString電影時長 示例:104 分鐘
typeString電影分類,多個用斜杠隔開 示例:奇幻/喜劇
actorsString主演,多個用斜杠隔開 示例:彭昱暢/周冬雨
movieReleaseTimeString電影上映時間 示例:2018-09-08
scoreString電影評分,當(dāng)電影未上映是可不填 示例:8.4
couponIDString優(yōu)惠券類型,跟卡券中心的 couponID 保持一致 示例:111

到店->演出賽事

字段名稱字段類型是否必填字段說明
couponIDString優(yōu)惠券類型,跟卡券中心的 couponID 保持一致 示例:111
locationString演出地點,必須寫清城市和具體地址 示例:重慶市人民大禮堂
nameString演出名 示例:2019 德云社齡龍相聲專場 重慶站
priceString價格 示例:199 起
timeString演出時間 示例:2019-11-02 周六 19:30

到店->美食

字段名稱字段類型是否必填字段說明
nameString商鋪名稱 示例:西貝莜面村
locationString商鋪地理位置信息(具體到城市) 示例:北京西城區(qū)
categoryString商鋪所屬分類 示例:日料
scoreString商鋪星級,十分制 示例:8.3
priceString人均價格 示例:200

電商->綜合

字段名稱字段類型是否必填字段說明
nameString商品名稱 示例:Apple Iphone X
priceString價格 示例:7099
category1String商品類別(一級) 示例:電子產(chǎn)品
favorableRateString好評率 示例:99%
category2String商品類別(二級) 示例:通訊
category3String商品類別(三級) 示例:手機
brandString品牌 示例:Apple
modelString型號 示例:(A1865) 64GB
couponIDString優(yōu)惠券類型,跟卡券中心的 couponID 保持一致 示例:111

旅游出行->酒店

字段名稱字段類型是否必填字段說明
nameString酒店名稱 示例:如家前門店
locationString酒店地理位置信息(具體到城市) 示例:北京西城區(qū)
scoreString酒店評分 示例:9.6
priceString價格 示例:468 元起
starLevelString酒店星級 示例:經(jīng)濟型酒店

旅游出行->景點門票

字段名稱字段類型是否必填字段說明
nameString景點名稱 示例:故宮
locationString景點地理位置信息(具體到城市) 示例:北京市東城區(qū)
scoreString景點評分 示例:9.6
priceString價格 示例:60 元

車主->汽車估值

字段名稱字段類型是否必填字段說明
modelString車系 示例:奧迪 Q3 2019 款
priceString報價 示例:26.46 萬-50 萬
brandString品牌 示例:奧迪

房產(chǎn)->綜合

字段名稱字段類型是否必填字段說明
nameString小區(qū)或者樓盤名稱 示例:融澤家園
priceString售賣/出租價格 示例:199 萬
locationString地址,必須寫清城市和具體地址 示例:重慶市人民大禮堂
squareString面積 示例:98m2

通用->其他

分類字段說明

序號分類名稱分類編碼父級分類編碼
1內(nèi)容10
2到店20
3電商30
4旅游出行40
5車主50
6房產(chǎn)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


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號