JS SDK - 网络请求
优质
小牛编辑
139浏览
2023-12-01
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 规范,返回的状态码与对应的请求方法相对应。
info
当返回 401 状态码时,SDK 会清除本地的客户端认证Token
、BaaS 登录状态和BaaS 用户信息(与调用wx.BaaS.logout()
退出 BaaS 一样)