微信小程序API接口
wx.request(OBJECT)网络请求
wx.request(OBJECT) wx.request发起的是 HTTPS 请求。
OBJECT参数说明:
url->开发者服务器接口地址->String;
data->请求的参数->Object、String;
header->设置请求的 header , header 中不能设置 Referer->Object;
method->默认为 GET,有效值:OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT->String;
dataType->默认为 json。如果设置了 dataType 为 json,则会尝试对响应的数据做一次 JSON.parse->String;
success->收到开发者服务成功返回的回调函数,res = {data: '开发者服务器返回的内容'}->Function;
fail->接口调用失败的回调函数->Function;
complete->接口调用结束的回调函数(调用成功、失败都会执行)->Function;
示例代码:
wx.request({ url: 'https://www.kg1995.top/mvshop/index.php/Api/Wen/getlist', //仅为示例,并非真实的接口地址 data: { x: '' , y: '' }, header: { 'content-type': 'application/json' }, success: function(res) { console.log(res.data) } })
开放接口:
wx.login(OBJECT)登录
object参数说明:
success->接口调用成功的回调函数->Function;
fail->接口调用失败的回调函数->Function;
complete->接口调用结束的回调函数(调用成功、失败都会执行)->Function;
success返回参数说明:
errMsg->调用结果->String;
code->用户允许登录后,回调内容会带上 code(有效期五分钟),开发者需要将 code 发送到开发者服务器后台,使用code 换取session_key
api,将 code 换成 openid 和 session_key ->String;
示例代码: 写在app.js中
//app.js App({ onLaunch: function() { wx.login({ success: function(res) { if (res.code) { //发起网络请求 wx.request({ url: 'https://test.com/onLogin', data: { code: res.code } }) } else { console.log('获取用户登录态失败!' + res.errMsg) } } }); } })
wx.getUserInfo(OBJECT) 获取用户信息,需要先调用wx.login 接口。
object参数信息:
withCredentials->是否带上登录态信息->Boolean;
success->接口调用成功的回调函数->Function;
fail->接口调用失败的回调函数->Function;
complete->接口调用结束的回调函数(调用成功、失败都会执行)->Function;
success返回参数说明:
userInfo->用户信息对象,不包含 openid 等敏感信息->OBJECT
rawData->不包括敏感信息的原始数据字符串,用于计算签名。->String;
signature->使用 sha1( rawData + sessionkey ) 得到字符串,用于校验用户信息,参考文档signature->String;
encryptedData->包括敏感数据在内的完整用户信息的加密数据,详细见加密数据解密算法->String;
wx.login({
success: function () {
wx.getUserInfo({ success: function(res) { var userInfo = res.userInfo var nickName = userInfo.nickName var avatarUrl = userInfo.avatarUrl var gender = userInfo.gender //性别 0:未知、1:男、2:女 var province = userInfo.province var city = userInfo.city var country = userInfo.country } })
}
})