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

2020-09-05 14:47 更新

接口提交物料介紹

物料提交接口

接口說(shuō)明:接口調(diào)用者需要記錄物料 id 和 path 信息。進(jìn)行物料修改和刪除時(shí)物料 id 和物料 path 信息為必填字段 。普通開(kāi)發(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  

請(qǐng)求方式: POST

接口參數(shù):

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

接口返回值

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

返回字段說(shuō)明:

path //小程序落地頁(yè) path 地址 id //物料唯一 id

物料修改接口

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

接口參數(shù):

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

接口返回值:

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

物料刪除接口

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

接口參數(shù):

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

接口返回值:

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

各個(gè)分類(lèi)擴(kuò)展字段說(shuō)明

內(nèi)容->小說(shuō)/動(dòng)漫

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

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

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

到店->電影

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

到店->演出賽事

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

到店->美食

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

電商->綜合

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

旅游出行->酒店

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

旅游出行->景點(diǎn)門(mén)票

字段名稱(chēng)字段類(lèi)型是否必填字段說(shuō)明
nameString景點(diǎn)名稱(chēng) 示例:故宮
locationString景點(diǎn)地理位置信息(具體到城市) 示例:北京市東城區(qū)
scoreString景點(diǎn)評(píng)分 示例:9.6
priceString價(jià)格 示例:60 元

車(chē)主->汽車(chē)估值

字段名稱(chēng)字段類(lèi)型是否必填字段說(shuō)明
modelString車(chē)系 示例:奧迪 Q3 2019 款
priceString報(bào)價(jià) 示例:26.46 萬(wàn)-50 萬(wàn)
brandString品牌 示例:奧迪

房產(chǎn)->綜合

字段名稱(chēng)字段類(lèi)型是否必填字段說(shuō)明
nameString小區(qū)或者樓盤(pán)名稱(chēng) 示例:融澤家園
priceString售賣(mài)/出租價(jià)格 示例:199 萬(wàn)
locationString地址,必須寫(xiě)清城市和具體地址 示例:重慶市人民大禮堂
squareString面積 示例:98m2

通用->其他

分類(lèi)字段說(shuō)明

序號(hào)分類(lèi)名稱(chēng)分類(lèi)編碼父級(jí)分類(lèi)編碼
1內(nèi)容10
2到店20
3電商30
4旅游出行40
5車(chē)主50
6房產(chǎn)60
7通用70
8小說(shuō)/動(dòng)漫100011
9影視劇100021
10電影200012
11演出賽事200022
12美食200032
13綜合300013
14酒店400014
15景點(diǎn)門(mén)票400024
16汽車(chē)估值500015
17綜合600016
18其他700017


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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)