• 网络请求
    • 状态码

    网络请求

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

    1. {
    2. "limit": 20,
    3. "next": null,
    4. "offset": 0,
    5. "previous": null,
    6. "total_count": 1
    7. }

    请求示例

    1. // 获取当前登录用户订单列表
    2. wx.BaaS.request({
    3. url: '/orderlist/',
    4. data: {orderby: 'orderID'}
    5. }).then(res => {
    6. // success
    7. }, err => {
    8. // err
    9. })

    状态码

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

    info
    当返回 401 状态码时,SDK 会清除本地的客户端认证 Token、BaaS 登录状态和BaaS 用户信息(与调用 wx.BaaS.logout() 退出 BaaS 一样)