百度智能小程序开发服务 开发者服务相关接口

2020-08-31 10:20 更新

开发者服务权限说明


使用对开发者服务相关接口需要先从智能小程序开发者平台申请该服务

调用服务权限校验方式:

Client Credentials 授权

采用 Client Credentials 方式,即应用公钥、密钥方式获取 Access Token, 后 Access Token 访问各服务接口。对于应用而言,其流程只有一步,即直接获取 Access Token。

使用 Client Credentials 获取 Access Token 需要应用在其服务端发送请求(推荐用POST方法)到百度 OAuth2.0 授权服务的 https://openapi.baidu.com/oauth/2.0/token 地址上,并带上以下参数:

grant_type:必须参数,固定为“client_credentials”
client_id: 必须参数,智能小程序的AppKey 从开发者平台中获取
client_secret:必须参数,智能小程序的AppSecret 从开发者平台中获取
scope:必须参数,固定为"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

响应数据包格式

{
  "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 过期可以重新获取。

各服务接口部分


1.消息推送服务单播接口

url: 邀请制,受邀开发者可使用该服务method: POSTparams:

key 类型 是否为空 备注 示例
access_token string false 权限校验TOKEN
app_id string false 智能小程序ID 1000001
swan_ids string false 智能小程序用户id(1-100个,逗号分隔) D43857DGDG,JDKFGJ94
title string false 手机通知栏标题 优惠活动
description string false 手机通知栏消息体 2018最大力度优惠
path_url string false 点开链接(智能小程序内页) /pages/detail/detail/
type int false 消息类型 固定值21 21
content string false 消息体 JSON格式

content 字段格式说明

"content": {
    "title":"积分变动通知"  //标题
    "first": { //消息体第一部分
        "value":"亲爱的用户,近期我们有如下优惠活动" //消息体第一部分文本
    },
    "keywords":[//消息主体 
        {
            "name":"服装类商品",
            "value":"满1000减100"
        },
        {
            "name":"日用品类商品",
            "value":"全部9折"
        }
        ...
    ]
}        

return:json

key 类型 备注
errno int 0
msg string 错误信息
data string push发送成功

返回示例

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

2.消息推送服务组播接口

url: 邀请制,受邀开发者可使用该服务method: POSTparams:

key 类型 是否为空 备注 示例
access_token string false 权限校验TOKEN
app_id string false 智能小程序ID 1000001
title string false 手机通知栏标题 优惠活动
description string false 手机通知栏消息体 2018最大力度优惠
path_url string false 点开链接(智能小程序内页) /pages/detail/detail/
type int false 消息类型 固定值21 21
content string false 消息体 JSON格式

content 字段格式说明

"content": {
    "title":"积分变动通知"  //标题
    "first": { //消息体第一部分
        "value":"亲爱的用户,近期我们有如下优惠活动" //消息体第一部分文本
    },
    "keywords":[//消息主体 
        {
            "name":"服装类商品",
            "value":"满1000减100"
        },
        {
            "name":"日用品类商品",
            "value":"全部9折"
        }
        ...
    ]
}          

return:json

key 类型 备注
errno int 0
msg string 错误信息
data string push发送成功

返回示例

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

3.Feeds横滑卡片推广接口

url: 该服务即将对外开放,敬请期待method: POSTparams:

key 类型 是否为空 备注 示例
access_token string false 权限校验TOKEN
app_id int false 智能小程序ID 1000001
mcard_title string false 主卡片标题(长度限制10个字) 精选影视推荐
recommend_type int false 推荐类型3智能小程序内容 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集,励志精英燃情商战
-img_url string false 子卡片图片url (长度限制:500个字,格式限制:JPG,高宽限制:456*306) http://xxx.xxx/1.jpg
-path_url string false 智能小程序调起路径 (长度限制:500个字) /pages/home/home/

scard_list 字段格式示例

"scard_list":[   
        {
            "scard_title":"金牌投资人",
            "scard_desc":"更新至6集,励志精英燃情商战",
            "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 发送成功

返回示例

{
  "errno":0,
  "msg":"success",
  "data":""
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号