百度智能小程序開發(fā)服務(wù) 開發(fā)者服務(wù)相關(guān)接口

2020-08-31 10:20 更新

開發(fā)者服務(wù)權(quán)限說明


使用對開發(fā)者服務(wù)相關(guān)接口需要先從智能小程序開發(fā)者平臺申請該服務(wù)

調(diào)用服務(wù)權(quán)限校驗方式:

Client Credentials 授權(quán)

采用 Client Credentials 方式,即應(yīng)用公鑰、密鑰方式獲取 Access Token, 后 Access Token 訪問各服務(wù)接口。對于應(yīng)用而言,其流程只有一步,即直接獲取 Access Token。

使用 Client Credentials 獲取 Access Token 需要應(yīng)用在其服務(wù)端發(fā)送請求(推薦用POST方法)到百度 OAuth2.0 授權(quán)服務(wù)的 https://openapi.baidu.com/oauth/2.0/token 地址上,并帶上以下參數(shù):

grant_type:必須參數(shù),固定為“client_credentials”
client_id: 必須參數(shù),智能小程序的AppKey 從開發(fā)者平臺中獲取
client_secret:必須參數(shù),智能小程序的AppSecret 從開發(fā)者平臺中獲取
scope:必須參數(shù),固定為"smartapp_snsapi_base"

例如:

https://openapi.baidu.com/oauth/2.0/token?grant_type=client_credentials&client_id=Va5yQRHlA4Fq4eR&client_secret=0rDSjzQ20XUj5itV7WRtznPQS&scope=smartapp_snsapi_base

響應(yīng)數(shù)據(jù)包格式

{
  "access_token":"1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328",
  "expires_in":86400,
  "refresh_token":"2.385d55f8615fdfd9edb7c4b5ebdc3e39.604800.1293440400-2346678-124328",
  "scope":"smartapp_snsapi_base",
  "session_key":"ANXxSNjwQDugf8615OnqeikRMu2bKaXCdlLxn",
  "session_secret":"248APxvxjCZ0VEC43EYrvxqaK4oZExMB"
}

默認情況下,Access Token 的有效期為一個月,如果 Access Token 過期可以重新獲取。

各服務(wù)接口部分


1.消息推送服務(wù)單播接口

url: 邀請制,受邀開發(fā)者可使用該服務(wù)method: POSTparams:

key 類型 是否為空 備注 示例
access_token string false 權(quán)限校驗TOKEN
app_id string false 智能小程序ID 1000001
swan_ids string false 智能小程序用戶id(1-100個,逗號分隔) D43857DGDG,JDKFGJ94
title string false 手機通知欄標題 優(yōu)惠活動
description string false 手機通知欄消息體 2018最大力度優(yōu)惠
path_url string false 點開鏈接(智能小程序內(nèi)頁) /pages/detail/detail/
type int false 消息類型 固定值21 21
content string false 消息體 JSON格式

content 字段格式說明

"content": {
    "title":"積分變動通知"  //標題
    "first": { //消息體第一部分
        "value":"親愛的用戶,近期我們有如下優(yōu)惠活動" //消息體第一部分文本
    },
    "keywords":[//消息主體 
        {
            "name":"服裝類商品",
            "value":"滿1000減100"
        },
        {
            "name":"日用品類商品",
            "value":"全部9折"
        }
        ...
    ]
}        

return:json

key 類型 備注
errno int 0
msg string 錯誤信息
data string push發(fā)送成功

返回示例

{
     "errno":0,
     "msg":"success",
     "data":{
         "msg_key":123456789
         }
}

2.消息推送服務(wù)組播接口

url: 邀請制,受邀開發(fā)者可使用該服務(wù)method: POSTparams:

key 類型 是否為空 備注 示例
access_token string false 權(quán)限校驗TOKEN
app_id string false 智能小程序ID 1000001
title string false 手機通知欄標題 優(yōu)惠活動
description string false 手機通知欄消息體 2018最大力度優(yōu)惠
path_url string false 點開鏈接(智能小程序內(nèi)頁) /pages/detail/detail/
type int false 消息類型 固定值21 21
content string false 消息體 JSON格式

content 字段格式說明

"content": {
    "title":"積分變動通知"  //標題
    "first": { //消息體第一部分
        "value":"親愛的用戶,近期我們有如下優(yōu)惠活動" //消息體第一部分文本
    },
    "keywords":[//消息主體 
        {
            "name":"服裝類商品",
            "value":"滿1000減100"
        },
        {
            "name":"日用品類商品",
            "value":"全部9折"
        }
        ...
    ]
}          

return:json

key 類型 備注
errno int 0
msg string 錯誤信息
data string push發(fā)送成功

返回示例

{
     "errno":0,
     "msg":"success",
     "data":{
         "msg_key":123456789
         }
}

3.Feeds橫滑卡片推廣接口

url: 該服務(wù)即將對外開放,敬請期待method: POSTparams:

key 類型 是否為空 備注 示例
access_token string false 權(quán)限校驗TOKEN
app_id int false 智能小程序ID 1000001
mcard_title string false 主卡片標題(長度限制10個字) 精選影視推薦
recommend_type int false 推薦類型3智能小程序內(nèi)容 3
templete_type int false 模板類型1大圖有摘要2大圖無摘要 1
scard_list string false 子卡片集合 (限制5-9個子卡片) JSON格式
-scard_title string false 子卡片標題 (長度限制:模板類型1限制8個字,模板類型2限制20個字) 金牌投資人
-scard_desc string 模板類型1必須 子卡片摘要 (長度限制:20個字) 更新至6集,勵志精英燃情商戰(zhàn)
-img_url string false 子卡片圖片url (長度限制:500個字,格式限制:JPG,高寬限制:456*306) http://xxx.xxx/1.jpg
-path_url string false 智能小程序調(diào)起路徑 (長度限制:500個字) /pages/home/home/

scard_list 字段格式示例

"scard_list":[   
        {
            "scard_title":"金牌投資人",
            "scard_desc":"更新至6集,勵志精英燃情商戰(zhàn)",
            "img_url":"http://xxx.xxx/1.jpg",
            "path_url":"/pages/home/home/",
        },
        {
            "scard_title":"南方有喬木",
            "scard_desc":"更新至31集,陳偉霆白百合分手淚崩",
            "img_url":"http://xxx.xxx/2.jpg",
            "path_url":"/pages/home/home/",
        }
        ...
    ]

return:json

key 類型 備注
errno int 0
msg string 錯誤信息
data string 發(fā)送成功

返回示例

{
  "errno":0,
  "msg":"success",
  "data":""
}
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號