微信小程序开发教程手册
> 微信小程序开发教程手册 > wx.request

wx.request(OBJECT)

​ wx.request发起的是Https请求。一个微信小程序，同时只能有5个网络请求连接。

OBJECT参数说明：

参数名 类型 必填 说明
url String 是 开发者服务器接口地址
data Object、String 否 请求的参数
header Object 否 设置请求的 header , header 中不能设置 referer
method String 否 默认为 GET，有效值：OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
dataType String 否 默认为 json。如果设置了 dataType 为 json，则会尝试对响应的数据做一次 JSON.parse
success Function 否 收到开发者服务成功返回的回调函数，res = {data: '开发者服务器返回的内容'}
fail Function 否 接口调用失败的回调函数
complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数 说明
data 开发者服务器返回的数据
statusCode 开发者服务器返回的状态码

data 数据说明 最终发送给服务器的数据是 String 类型，如果传入的 data 不是 String 类型，会被转换成 String 。转换规则如下：

  • 对于 header['content-type'] 为 'application/json' 的数据，会对数据进行 JSON 序列化
  • 对于 header['content-type'] 为 'application/x-www-form-urlencoded' 的数据，会将数据转换成 query string （encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...）

示例代码：

wx.request({
  url: 'test.php', //仅为示例，并非真实的接口地址
  data: {
     x: '' ,
     y: ''
  },
  header:{
      "Content-Type":"application/json"
  },
  success: function(res) {
     var data = res.data;
  }
});

Bug & Tip

  1. tip: content-type 默认为 'application/json'
  2. bug: 开发者工具 0.10.102800 版本，header 的 content-type 设置异常；
  3. tip: 客户端的 HTTPS TLS 版本为1.2，但 android 的部分机型还未支持 TLS 1.2，所以请确保 HTTPS 服务器的 TLS 版本支持1.2及以下版本；
  4. tip: 要注意 method 的 value 必须为大写（例如：GET）；
  5. tip: url 中不能有端口；
  6. tip: request 的默认超时时间和最大超时时间都是 60s
  7. tip: request 的最大并发数是 5
  8. tip: 网络请求的 referer 是不可以设置的，格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版。

下一篇：