登录

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

流程说明

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

摄像头

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);

}

})