网络请求

BaaS 提供 wx.BaaS.request(OBJECT) 接口用于调用 API。

wx.BaaS.request() 相比 wx.request() 的优势：

  • 支持 Promise 规范
  • 方便 BaaS 分析接口调用状况
  • 无需关心微信 wx.request() 方法是否更新
  • 自动配置必要的参数

OBJECT 参数说明

参数 类型 必填 说明
url String 是 接口地址
method String 是 默认为 GET，有效值：OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
data Object/String 否 请求参数
header Object 否 设置请求的 header , header 中不能设置 Referer
dataType String 否 默认为 json

返回参数

BaaS 提供的 API，如果返回结果是与列表相关的，返回参数中会附有 meta 元信息，其结构如下：

参数 类型 说明
total_count Number 列表中元素总数
next String 下页地址
previous String 上页地址
limit Number 每次拉取数量的最大值，见 Tip
offset Number 相对起始位置的偏移量

meta 返回示例

  1. {
  2.   "limit": 20,
  3.   "next": null,
  4.   "offset": 0,
  5.   "previous": null,
  6.   "total_count": 1
  7. }

请求示例

  1. // 获取当前登录用户订单列表
  2. wx.BaaS.request({
  3.   url: '/orderlist/',
  4.   data: {orderby: 'orderID'}
  5. }).then(res => {
  6.   // success
  7. }, err => {
  8.   // err
  9. })

状态码

BaaS 提供的 API 遵循 RESTful 规范，返回的状态码与对应的请求方法相对应。

info 当请求知晓云提供的接口返回 401 状态码时，SDK 会清除本地的客户端认证 Token、BaaS 登录状态和BaaS 用户信息（与调用 wx.BaaS.logout() 退出 BaaS 一样）

请求外部域名接口时，将不会进行上述处理。在发起请求前一定要确认小程序域名配置已经完成。

受小程序业务域名配置的限制，插件版的 wx.BaaS.request 不支持请求自定义 URL （即只能访问知晓云服务相关的 URL）