# 网络请求

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

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

**请求示例**

```javascript
// 获取当前登录用户订单列表
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 一样）
>
> 请求外部域名接口时，将不会进行上述处理。在发起请求前一定要确认小程序域名配置已经完成。
>
> 受小程序业务域名配置的限制，插件版的 wx.BaaS.request 不支持请求自定义 URL （即只能访问知晓云服务相关的 URL）