连wifi之前wi-fi开发faq Wi Fi常见问题汇总

1、连 Wi-Fi 常见问题汇总连Wi-Fi 出现异常的可能性312获取Wi-Fi时，出现GetQrcode Additional information:Assert.AreEqual 失败。应为: ，实际为: 。生成服务发生错误，生成失败 的提示。43.一个是否绑定一个，只能添加 1 个 AP 设备而不能添加 2 个以上进行调试？44.获取白时出现token的提示45.IOS 的白. 56.设置 AP 时，出现vendor not found的提示。57.AP 信息到系统是以什么信息进行识别？58 有无获取 AP 信息的接口,如何确认 AP 是否设置成功的？59 设置 AP 信息是否支持分批设

2、置？510.设置 AD 时出现API 系统错误的提示611.当扫完成连接Wi-Fi 但没有显示相应的 AD 页面612.portal 上号如何绑定？613.回调请求server 请求参数说明614.回调请求客户端返回参数说明715.设置Wi-Fi 开发者配置信息参数说明（callbackUrl、token）716. IOS 自动弹portal（认证页）的解决方法717. 使用 PC 扫码之后，出现”网络连接已过期，店员 ”的提示818. 使用同一个acs_token 调用不同的API,但是有的能调用成功，有的提示”token”？ . 819.bar 什么时候出现？820. 外部JSAPI 无法

3、调起？ . 821.扫码后无法拉取到自定义BAR？922.P6，扫码AP 成功后，会调起浏览器打开腾讯介绍页？923.OPPO 等部分机型， 从wifi1 扫码连接wifi2 时，无法成功？924. 1 AP 多b如何进行上报？925. 关于通知action 状态上报91连Wi-Fi 出现异常的可能性答：根据连 Wi-Fi 的流程，出现异常有以下几种可能：1） 当正常扫码后，发起请求（步骤 6），AP 未进行 302 跳转并回传正确的 auth 信息。2） 当发起白请求时（步骤 8），未设置白到 AP 中、未设置Wi-Fi 开发者配置信息（设置 callbackUrl 和 token）、客户端

4、未收到回调请求（步骤 10）、客户端针对回调请求返回给server 参数错误（步骤 11，参数错误如：某些参数必填 store_name、store_id、device_no 等，login_allow 未设置等）这四种情况都将导致白返回错误。3） 当发起 login 请求时（步骤 13），AP 未进行 302 跳转携带 res 参数。4） 当走完了步骤 13，并且 AP 返回了 302 跳转并携带 res 参数，但还是显示连接中，此时应检查接口回调请求返给server 的参数，当返回参数异常时（如将英文的” ”写成中文的“ ”，参数类型为字符串但未带” ”等），将导致微信连 Wi-Fi 一直

5、处在连接中。2 获取 Wi-Fi时， 出现GetQrcode Additional information:Assert.AreEqual 失败。应为: ，实际为: 。生成服务发生错误，生成失败 的提示。答：针对连 wifi 1.0 之前版本，客户端(开发者)是否提供物料底图，未提供则会出现上述提示；连wifi 1.0 之后版本，不需要提供物料底图，需要设置templateId=1。检查T 的参数的拼写、类型及取值（如将 lgnId 写成 lgnid，bgurl的不能），注意和 PC 获取 Wi-Fi的参数不一致等等（如当 PC 设备获取时需传lgnId,获取时则不需传此参数；当 PC 设备获

6、取时需传入 templateId 为 100）。3.一个是否绑定一个，只能添加 1 个AP 设备而不能添加 2 个以上进行调试？答：目前可带门店 id 信息，但还不是必填，建议一个只对应到一个门店，多个门店不建议使用同一个；一个门店下可以有多个 AP。4.获取白时出现token的提示答：由于获取白信息参数只有 acs_token 和 format（值固定为 json）两个参数,所以可从 acs_token 入手，通过客户端(开发者)的 ap和 secret 重新生成一个acs_token 并调用获取白信息看看是否能成功返回白信息，若成功则说明旧的 acs_token 已被刷新掉。5.IOS 的

7、白答：6.设置 AP 时，出现vendor not found的提示。答：客户端(开发者)未提供 callbackurl、token,未添加vendor。7.AP 信息到系统是以什么信息进行识别？答：以 deviceno 作为唯一标识。8 有无获取 AP 信息的接口,如何确认 AP 是否设置成功的？答：设置 AP 失败会有 errorcode 和 errormsg,当 AP 设置失败时设置 AD 会提示不存在。9 设置 AP 信息是否支持分批设置？答：设置 AP 是批量接口，支持传 aplist，并且 AP 是可以覆盖更新的，根据 deviceno 来更新。10. 设置AD 时出现API 系统

8、错误的提示答：检查T 参数的拼写、类型及取值（ 如 deviceNos 是 json 串， 取值应为deviceNos:deviceno1,deviceno2;请求参数为字符串时，必须加）。11. 当扫完成连接Wi-Fi 但没有显示相应的 AD 页面答：可以考虑以下两个可能性：1） 未调用设置AD 接口。2）server 调用客户端的服务器做的时候，设备正确返回device_no（回调请求设备商返回给server 的AP 序列号必须与接口设置AP 信息中的一致）。12.portal 上号如何绑定？答：设置 AD 信息中有一参数 mpAccount-公众账号的，如果设置且为真实的号则显示“关注”

9、按钮。13. 回调请求server 请求参数说明答：lgnid 是 pc 认证才会有的，当调用接口 2 获取 Wi-Fi时传入(接口 2 获取 WIFI中，当 PC 设备获取动态时传入的 lgnId)。wxuid 是全局唯一，目前是用户的 openId,和的 openId 无关系。14. 回调请求客户端返回参数说明答：login 是最后登录认证用的，可以是设备商服务器地址，也可以是设备商的 ap 的内网认证地址，不同设备商实现方式都不一样，只是原样请求，目的是让 ap 放行并通知。key 的规则也是由客户端定,不做任何处理(返回 login 时，不需要对整个 url 作编码，一般只需要对所带的

10、参数的值作编码即可，server 会自动)。logout 参数目前未做控制。login_allow 为允许上网时间，默认为 0,必须重新设置 login_allow（客户端Android 版已做，IOS 版未做，若不重新设置，则可能导致 IOS 设备能完成连 Wi-Fi 上网流程，而 Android 设备则不能完成连 Wi-Fi 上网）。15. 设置Wi-Fi 开发者配置信息参数说明（callbackUrl、token）答：callbackUrl 即回调URL,token 即SERVER 在回调请求时会带上此token，这样 Wi-Fi 开发者可以检验调用是否来自，而不是其他不的调用。16.

11、IOS 自动弹portal（认证页）的解决方法答：目前有两个解决办法，如下所示：1）把 IOS 服务器设置到白；2） AP 上判断 http 的请求的 useragent 带有 captive network support， 直接放行，或者直接返回 sucs 给这个 http 请求。17. 使用PC 扫码之后，出现”网络连接已过期，店员 ”的提示答：查看接口 2 获取 Wi-Fi传的 expiretime 参数，expiretime 为过期时间，是为秒的 UNIX 时间戳。某些开发者给到的是毫秒级的数据，导致时间较短，二维码失效，从而出现此提示，建议开发者调整 expiretime 为秒级

12、UNIX 时间戳。18. 使用同一个 acs_token 调用不同的 API,但是有的能调用成功，有的提示”token”？答： 接口的调用频率限制不一样，即每天调用次数不同。超出限制，则会提示”token 非法 ”。19.bar 什么时候出现？答： 可以分为以下几种情况1）客户端（android、IOS 设备）经过扫码后，会出现bar。2） 当客户端（android、IOS 设备）之前已进行过扫码连接，现在离开 AP再次进入的话，客户端会自动连接AP 出现bar。20. 外部JSAPI 无法调起？答： 商家 setAP 时，未将b（无线 MAC）入。21.扫码后无法拉取到自定义BAR？答：获取

13、自定义 BAR 内容，必须满足 2 个条件，第一，客户端为 6.0.2 及以上（以下的APAUTH 未上传无线 MAC 地址），第二，商家 b（无线 MAC）已经否则无法获取到自定义 BAR。22.P6，扫码AP 成功后，会调起浏览器打开腾讯介绍页？答：P6 系统发起了 HTTP 请求，因为没在白里，因此弹出上面这个 302 页面,开发者应加入白并升级固件。23.OPPO 等部分机型， 从wifi1 扫码连接wifi2 时，无法成功？答：安卓系统。导致调取系统切换网络的接口出错，OPPOX909 android4.2.2 手机在其他WIFI 下扫码连接时，LOG 提示当前网络没有切换到要连的 WIFI，锁屏再解锁后才连上了该 WIFI。C8816D 在其他 WIFI 下扫码连接时，l