百度智能小程序API 开放接口

由 Carrie 创建, 最后一次修改 2018-07-10

登录


智能小程序可以通过百度官方提供的登录能力方便地获取百度提供的用户身份标识,快速建立智能小程序内的用户体系。

流程说明

1、调用 swan.login() 获取 临时登录凭证code ,并回传到开发者服务器。

2、开发者服务器以 code 换取 session_key。

3、调用 swan.getUserInfo() 获取用户信息。

4、点击查看详细流程。

login

解释: 调用接口 swan.login 获取 临时登录凭证(code)

参数: Object

Object参数说明:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明:

参数 类型 说明
code String 用户登录凭证(有效期五分钟)。开发者需要在开发者服务器后台调用 api,使用 code 换取 session_key 等信息

示例:

swan.login({
    success: function (res) {
        swan.request({
            url: 'https://xxx/xxx', // 开发者服务器地址
            data: {
                code: res.code
            }
        });
    },
    fail: function (err) {
        console.log('login fail', err);
    }
});

登录凭证校验

临时登录凭证校验接口是一个 HTTPS 接口,开发者服务器使用 临时登录凭证(code) 获取 session_key。

注意:

1、会话密钥 session_key 是对用户数据进行加密签名的密钥。为了应用自身的数据安全,开发者服务器不应该把会话密钥下发到智能小程序,也不应该对外提供这个密钥。

2、临时登录凭证 code 只能使用一次。

接口地址:https://openapi.baidu.com/nalogin/getSessionKeyByCode

请求参数

参数 说明
client_id 开放平台申请的 App Key
sk 开放平台申请的 App Secret
code swan.login 返回的临时登录凭证

Bug & Tip

1、tip: 调用 login 会引起登录态的刷新,之前的 session_key 可能会失效。

checkSession

解释:通过上述接口获得的用户登录态拥有一定的时效性,用户越久未使用智能小程序,用户登录态越有可能失效;反之如果用户一直在使用智能小程序,则用户登录态一直保持有效。具体时效逻辑由百度 App 维护,对开发者透明。开发者可以调用 swan.checkSession 接口 检测当前用户登录态是否有效,登录态过期后开发者可以再调用 swan.login 获取新的用户登录态。

参数:Object

Object参数说明:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例:

swan.checkSession({
    success: function (res) {
        console.log('登录态有效');
    },
    fail: function (err) {
        console.log('登录态无效');
    }
});

用户数据的签名验证和加解密

智能小程序可以通过各种前端接口获取百度提供的开放数据。考虑到开发者服务器也需要获取这些开放数据,百度会对这些数据做签名和加密处理。开发者后台拿到开放数据后可以对数据进行校验签名和解密,来保证数据不被篡改。

加密数据解密算法

接口如果涉及敏感数据,接口的明文内容将不包含这些敏感数据。开发者如需要获取敏感数据,需要对接口返回的加密数据(data)进行对称解密。

解密过程:开发者智能小程序(通过 swan.request)将加密数据发送至自身 Server 进行解密后返回智能小程序。

解密算法如下:

1、对称解密使用的算法为 AES-128-CBC,数据采用PKCS#7填充。

2、对称解密的目标密文为 Base64_Decode(data)。

3、对称解密秘钥 AESKey = Base64_Decode(session_key), AESKey 是24字节。

4、对称解密算法初始向量 为Base64_Decode(iv),其中iv由数据接口返回。

授权


authorize

解释:提前向用户发起授权请求。调用后会立刻弹窗询问用户是否同意授权智能小程序使用某项功能或获取用户的某些数据,但不会实际调用对应接口。如果用户之前已经同意授权,则不会出现弹窗,直接返回成功。

参数:Object

Object参数说明:

参数名 类型 必填 说明
scope String 需要获取权限的 scope,详见 scope 列表
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

scope 列表

scope 对应接口 描述
scope.userInfo swan.getUserInfo 用户信息
scope.userLocation swan.getLocation, swan.chooseLocation 地理位置
scope.writePhotosAlbum swan.saveImageToPhotosAlbum 保存到相册
scope.address swan.chooseAddress 收获地址
scope.invoiceTitle swan.chooseInvoiceTitle 发票抬头
scope.record swan.getRecorderManager 录音功能
scope.camera <camera/> 摄像头

success返回参数说明:

参数名 类型 说明
errMsg String 调用结果

示例:

swan.authorize({
  scope: 'scope.userLocation',
  success: function (res) {
    // 用户已经同意智能小程序使用定位功能
    swan.getLocation();
  }
});

Bug & Tip

1、tip: 授权操作为异步操作,完成前请不要多次调用。

用户信息


swanid 机制说明

swanid 是用户使用智能小程序时的标识符,开发者可以通过 swanid 来区分用户的唯一性。

1、用户在非登陆情况下使用智能小程序时,在同一台设备上使用同一个开发者所开发的不同智能小程序,得到的是相同的 swanid。2、用户在登陆情况下使用智能小程序时,在多台不同设备上使用同一个开发者所开发的不同智能小程序,得到的是相同的 swanid。3、用户使用同一台设备时,在非登陆情况下与登陆情况下使用同一个智能小程序,得到的 swanid 是不同的。

getSwanId

解释:获取 swanid。

参数:Object

Object参数说明:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数 类型 说明
errno String errno
data Object {swanid}
errmsg String errmsg

示例:

swan.getSwanId({
    success: function (res) {
        console.log(res.data.swanid);
    }
});
getUserInfo

解释:获取用户信息

参数:Object

Object参数说明:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数 类型 说明
userInfo Object 用户信息对象
data String 包括敏感数据在内的完整用户信息的加密数据,加解密逻辑参考用户数据的签名验证和加解密
iv String 加密算法的初始向量

userInfo参数说明:

参数 类型 说明
nickName String 用户名
avatarUrl String 用户头像
gender String 性别

示例:

swan.getUserInfo({
    success: function (res) {
        console.log('用户名', res.nickName);
    }
});

设置


openSetting

解释:调起客户端智能小程序设置界面,返回用户设置的操作结果。

参数:Object

Object参数说明:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数 类型 说明
authSetting Object 用户授权结果,其中 key 为 scope 值,value 为 Bool 值,表示用户是否允许授权

示例:

swan.openSetting({
    success: function (res) {
        console.log(res.authSetting['scope.userInfo']);
        console.log(res.authSetting['scope.userLocation']);
    }
});

getSetting

解释:获取用户的当前设置

参数:Object

Object参数说明:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数 类型 说明
authSetting Object 用户授权结果,其中 key 为 scope 值,value 为 Bool 值,表示用户是否允许授权

示例:

swan.getSetting({
    success: function (res) {
        console.log(res.authSetting['scope.userInfo']);
        console.log(res.authSetting['scope.userLocation']);
    }
});

分享


onShareAppMessage

解释:在 Page 中定义 onShareAppMessage 函数,设置该页面的分享信息。

  • 用户点击分享按钮的时候会调用
  • 此事件需要 return 一个Object,用于自定义分享内容

参数:Object

Object参数说明:

参数名 类型 说明
from String 分享事件来源。button:页面内转发按钮;menu:右上角分享菜单
currentTarget Object 如果 from 值是 button,则 currentTarget 是触发这次转发事件的 button,否则为 undefined

自定义分享字段:

参数名 类型 必填 说明
title String 分享标题
content String 分享内容
imageUrl String 分享图标
path String 页面 path ,必须是以 / 开头的完整路径
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例:

Page({
    onShareAppMessage() {
        return {
            title: '智能小程序示例',
            content: '世界很复杂,百度更懂你',
            path: '/pages/openShare/openShare?key=value'
        };
    }
});
Bug & Tip

1、bug: iOS 点击分享面板的取消时,会执行 fail,Android 不会执行。

收获地址


chooseAddress

解释:调起用户编辑收货地址原生界面,并在编辑完成后返回用户选择的地址。

需要用户授权 scope.address

参数:Object

Object参数说明:

参数名 类型 必填 说明
success Function 返回用户选择的收货地址信息
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名 类型 说明
errMsg String 调用结果
userName String 收货人姓名
postalCode String 邮编
provinceName String 国标收货地址第一级地址
cityName String 国标收货地址第二级地址
countyName String 国标收货地址第三级地址
detailInfo String 详细收货地址信息
telNumber String 收货人手机号码

示例:

swan.chooseAddress({
    success: function (res) {
        console.log(res.userName);
        console.log(res.postalCode);
        console.log(res.provinceName);
        console.log(res.cityName);
        console.log(res.countyName);
        console.log(res.detailInfo);
        console.log(res.telNumber);
    }
});

聚合收银台支付


requestPolymerPayment

版本:百度 App 10.7.0 版本开始支持。

解释:百度聚合收银台,聚合了主流的百度钱包、微信、支付宝、网银等多种支付方式,方便开发者一站式快速接入多种支付渠道,让百度用户能在智能小程序场景下,直接完成支付、交易闭环,提升用户支付体验的同时,提高智能小程序的订单转化率。

了解更多信息,请查看 百度电商开放平台:产品介绍

参数:Object

Object参数说明:

参数名 类型 必填 说明
orderInfo Object 订单信息
bannedChannels StringArray 需要隐藏的支付方式
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

orderInfo 参数说明:

  • dealId: 跳转百度收银台支付必带参数之一,是百度收银台的财务结算凭证,与账号绑定的结算协议一一对应,每笔交易将结算到dealId对应的协议主体。
  • appKey: 用以表示应用身份的唯一ID,在应用审核通过后进行分配,一经分配后不会发生更改,来唯一确定一个应用。
  • totalAmount: 订单金额,单位为人民币分。
  • tpOrderId: 商户平台自己记录的订单ID,当支付状态发生变化时,会通过此订单ID通知商户。
  • dealTitle: 订单的名称。
  • rsaSign: 对appKey+dealId+tpOrderId进行RSA加密后的密文,防止订单被伪造。签名过程见 百度电商开放平台:签名与验签
  • bizInfo: 订单详细信息,需要是一个可解析为JSON Object的字符串。字段内容见: 百度电商开放平台:收银台接入

bannedChannels 参数说明:

channel 说明
Alipay 支付宝
BDWallet 百度钱包
WeChat 微信支付

示例:

swan.requestPolymerPayment({
    orderInfo: {
        "dealId": "470193086",
        "appKey": "MMMabc",
        "totalAmount": "1",
        "tpOrderId": "3028903626",
        "dealTitle": "智能小程序Demo支付测试",
        "rsaSign": '',
        "bizInfo": ''
    },
    success: function (res) {
        swan.showToast({
            title: '支付成功',
            icon: 'success'
        });
    },
    fail: function (err) {
        swan.showToast({
            title: JSON.stringify(err)
        });
        console.log('pay fail', err);
    }
});

获取发票抬头


chooseInvoiceTitle

解释:选择用户的发票抬头。

需要用户授权 scope.invoiceTitle

参数:Object

Object参数说明:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名 类型 说明
type String 抬头类型(0:单位,1:个人)
title String 抬头名称
taxNumber String 抬头税号
companyAddress String 单位地址
telephone String 手机号码
bankName String 银行名称
bankAccount String 银行账号
errMsg String 接口调用结果

示例:

swan.chooseInvoiceTitle({
    success: function (res) {
        console.log(res.type);
        console.log(res.title);
        console.log(res.taxNumber);
        console.log(res.companyAddress);
        console.log(res.telephone);
        console.log(res.bankName);
        console.log(res.bankAccount);
    }
})
以上内容是否对您有帮助:
二维码
建议反馈
二维码