目录

JS SDK - 网络请求

优质
小牛编辑
139浏览
2023-12-01

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

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

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

OBJECT 参数说明

参数类型必填说明
urlString接口地址
methodString默认为 GET,有效值:OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
dataObject/String请求参数
headerObject设置请求的 header , header 中不能设置 Referer
dataTypeString默认为 json

返回参数

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

参数类型说明
total_countNumber列表中元素总数
nextString下页地址
previousString上页地址
limitNumber每次拉取数量的最大值,见 Tip
offsetNumber相对起始位置的偏移量

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 一样)