网络请求

网络请求

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 规范，返回的状态码与对应的请求方法相对应。

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

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