网络请求

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

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

  • 支持 Promise 规范
  • 方便 BaaS 分析接口调用状况
  • 无需关心 swan.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
}

请求示例

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

状态码

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

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

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

results matching ""

    powered by

    No results matching ""