1、用户准备事项汇总

（1）完成小程序对接功能开发。

（2）客户需要确保小程序已备案、已上线，且在小程序后台做好了该有的配置，详见开发对接准备事项第3点。

（3）客户需要准备小程序认证使用域名及相应证书(可复用已有域名与证书)，固定公网IP，并映射控制器的TCP:4433端口。

以上为汇总准备事项，具体详细对接流程与步骤见后续章节

2、小程序对接整体流程

信锐控制器微信小程序整体认证流程如下：

                                                         图1 流程图

 

3、对接关键接口描述

详细代码示例见附件index.js： index.js.7z ( 0.00M ,下载次数:52) ---下载后请解压获取index.js

3.1、接口1(图1步骤3)

描述：Portal页面通过明文scheme链接访问小程序，在链接中拼接参数传递给小程序，参数在后续接口2与接口3中用于标识终端设备信息。

明文Scheme文档：

https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html

格式：

weixin://dl/business/?appid=xxx&path=xxx&query=xxx

参数	描述
appid	小程序对应应用id，由客户提供
path	小程序跳转页面路径
query	传递的设备信息，有多个参数时需要urlcode转换

 

示例：

$query：dev_info=6EF6B0621589_0&mp_auth_inner=1

weixin://dl/business/?appid=wxc1fec04e5b28a18b&path=pages/index/index&query=$query

 

weixin://dl/business/?appid=wxc1fec04e5b28a18b&path=pages/index/index为小程序链接。
$query为携带参数格式，其中6EF6B0621589_0为dev_info，mp_auth_inner用于判断是否为内置portal服务器，如果是则mp_auth_inner的值为1，内置portal服务器和普通无线portal的接口api地址有所差异；为无线认证portal时portal页面跳转到小程序默认不会传mp_auth_inner参数。

3.2、小程序获取用户code(图1步骤3)

在图1步骤3中，需要小程序通过官方提供的接口，在获得用户授权后，获取用户code。具体实现方案参照官方开发链接：

https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getPhoneNumber.html

3.3、接口2(图1步骤4)

描述：小程序获取用户code后，通过本接口将code传递给控制器后台，后台解析后，返回手机号。

格式：

GET https://域名:4433/get_mp_user_info.api?code=xxxx&dev_info=xxxx

（如果是内置portal服务器，api地址需要替换为get_mp_user_info_inner.api）

参数	描述
code	获取的用户code
dev_info	传递给小程序的参数

 

返回格式:

{

 "result": 0, （0成功 其他失败）

 "account":"手机号"

 "dev_info":"xxxxx"

}

3.4、接口3(图1步骤7)

描述：小程序通知后台用户完成认证，允许上线。

格式：

url: https://域名:4433/mp_auth_login.api  

（如果是内置portal服务器，api地址需要替换为mp_auth_login_inner.api）

参数	描述
account	手机号字符串
dev_info	传递给小程序的参数

 

返回格式:

{

"result" : 0,（0成功 其他失败）

"message" : "0-Authentication successful"

}

3.5、示例代码index.js

index.js.7z ( 0.00M ,下载次数:45) ---下载后请解压获取index.js

本示例采用微信官方的小程序开发框架语法。

 

出现接口调用失败时，在控制器系统日志中会有相关日志：

4、微信小程序配置

4.1、微信平台开发配置

客户进行小程序中对接功能开发，按照章节二的流程图，参照关键接口格式完成对接。

小程序后台配置：

（1）点击小程序左下角图标，账号设置->隐私与安全->明文scheme拉起此小程序，配置开启明文scheme并设置好path（对应小程序在认证时展示的页面路径）

（2）服务器域名，在[开发管理]->[服务器域名]，request合法域名需要添加上映射控制器IP的域名和4433端口：

（3）如需使用PC端认证，则需要在[开发管理]-[扫普通链接二维码打开小程序]中添加上对应地址，需要在改地址域名后台目录中增加对应的校验文件

 

4.2、控制器配置

（1）控制器的[证书管理]页面导入合法的服务器证书：

（2）[系统配置]-设备证书选择客户自己的合法证书；

注意：如果是集中管理环境，分支设备也需要导入证书，建议使用通配符域名的证书；

（3）[微信小程序]页面，添加微信小程序配置。

A、Appid、App Secret:小程序对应应用id及secret

B、小程序页面路径：小程序跳转页面路径

C、PC端二维码链接：具体见<微信平台开发对接准备>章节中的配置方法

D、本机服务域名：需要与设备证书中的域名一致，该域名需要可以解析到控制器的地址，且控制器的TCP:4433端口需要映射到公网，终端可以通过这个域名访问控制器的TCP:4433端口；集中管理环境建议使用子域名，各分支设备的域名需要不同；

（4）[访客认证]页面新增小程序认证的访客认证。

（5）无线网络portal认证，创建无线网络账号访客认证，引用包含小程序认证的访客认证方式，注意：当前小程序认证Portal认证页面仅支持通用定制模板，不支持其他模板，支持基于[通用可定制模板]进行复制。

 

5、微信小程序手机号码收费说明

微信相关说明链接：

https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getPhoneNumber.html

收费说明：

免费规则：