网络请求

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

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

  • 支持 Promise 规范
  • 方便 BaaS 分析接口调用状况
  • 无需关心 qq.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. qq.BaaS.request({
  3. url: '/orderlist/',
  4. data: {orderby: 'orderID'}
  5. }).then(res => {
  6. // success
  7. }, err => {
  8. // err
  9. })

状态码

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

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

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