网络请求

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 返回示例

{
  "limit": 20,
  "next": null,
  "offset": 0,
  "previous": null,
  "total_count": 1
}

请求示例

// 获取当前登录用户订单列表
wx.BaaS.request({
  url: '/orderlist/',
  data: {orderby: 'orderID'}
}).then(res => {
  // success
}, err => {
  // err
})

状态码

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

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

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

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

results matching ""

    powered by

    No results matching ""