微信小程序API~GET
框架提供丰富的微信原生API,可以方便的调起微信提供的能力,如获取用户信息,本地存储,支付功能等
1. wx.on 开头的 API 是监听某个事件发生的API接口,接受一个 CALLBACK 函数作为参数。当该事件触发时,会调用 CALLBACK 函数
2. 如未特殊约定,其他 API 接口都接受一个OBJECT作为参数
3. OBJECT中可以指定success, fail, complete来接收接口调用结果
1. wx.request(OBJECT)用来向指定的地址(url)根据指定的方式(method)发送带有参数(data)的请求,并根据(success/fail/complete)来处理获取到的数据
注:发送到服务器的参数data的最终格式是String类型,如果传入的data不是String类型,则会被转换成String
2. wx.getStorageSync(KEY)用来从本地缓存中同步获取指定 key 对应的内容,参数key是指本地缓存中的指定的key
3. wx.navigateTo(OBJECT)用来在保留当前页面的情况下,跳转到应用内的某个页面,使用wx.navigateBack可以返回到原页面
4. wx.redirectTo(OBJECT)用来关闭当前页面,并跳转到应用内的某个页面
5. wx.navigateBack(OBJECT)用来关闭当前页面,返回上一页面或多级页面。可通过 getCurrentPages()) 获取当前的页面栈,决定需要返回几层
6. wx.getUserInfo(OBJECT)用来获取用户信息,withCredentials 为 true 时需要先调用 wx.login 接口
6.1 参数withCredentials表示是否带上登录态信息,当 withCredentials 为 true 时,要求此前有调用过 wx.login 且登录态尚未过期,此时返回的数据会包含 encryptedData, iv 等敏感信息;当 withCredentials 为 false 时,不要求有登录态,返回的数据不包含 encryptedData, iv 等敏感信息
7 wx.login(OBJECT)用来获取用户登录态,具体是通过获取登录凭证(code)进而换取用户登录状态信息,包括用户的唯一标识(openid) 及本次登录的会话**(session_key)(用来解密之前被加密的用户数据)
这里将获取到的’res.code’发送到开发者后台服务器以换取session_key,如果用户是被允许登录的,那么返回的code便为true值,开发者需要将 code 发送到开发者服务器后台,换取所登录的用户的唯一标识符openid
通过向指定的接口地址发送code后,获取到的数据格式
8. wx.checkSession(OBJECT)用来检测当前用户登录状态是否有效,如果登录过期那么需要调用wx.login重新获取用户的登录态
首先用户’wx.login’登录后获取到’res.code’,然后将其发送给开发者服务器,开发者服务器将其再发送给微信服务器来获取用户的openid和sessionkey等绝密信息,开发者服务器会用获取到的openid和sessionkey来生成开发者服务器和小程序之间进行验证的session,最后将这个生成的保存有用户信息的session发送给小程序本地保存,用来在使用’wx.checksession’的时候进行从本地到第三方服务器的session验证,看两者所保存的session是否相同,如果不相同,那么登录验证失败重新回到’wx.login’执行之前的逻辑
9. wx.setStorageSync(KEY,DATA)用来将 data 存储在本地缓存中指定的 key 中,会覆盖掉原来该 key 对应的内容,这是一个同步接口
10. wx.showToast(OBJECT)用来显示消息提示框
11. wx.showLoading(OBJECT)用来显示 loading 提示框, 需主动调用 wx.hideLoading 才能关闭提示框
版权声明:本文为匿名原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。