request接口调用（小程序开发） | 青训营笔记

request接口调用

在小程序开发中，经常需要向后台服务器发起请求获取数据，这就需要使用小程序中的 request API。request API 是一个非常重要的小程序运行接口，它可以向后台发送各种类型的 HTTP 请求，并将返回的数据以异步的方式呈现在小程序页面上。

request 调用原型：wx.request(OBJECT)

其中，OBJECT 是一个 Object 类型的参数，表示请求的配置项。它包含以下属性：

• url：string，必填属性，表示请求的 URL 地址。
• method：string，可选属性，表示请求方式，包括：GET、POST、PUT、DELETE、OPTIONS 等。
• data：string/object/ArrayBuffer，可选属性，表示请求的数据，可以是字符串、对象或 ArrayBuffer 类型。例如，可以将 POST 请求的数据放在 data 属性中传递。
• header：Object，可选属性，表示请求的 header，header 是一个 JavaScript 对象，键表示头部字段名称，值为头部字段的值。
• success：function，可选属性，表示请求成功后的回调函数。
• fail：function，可选属性，表示请求失败后的回调函数。
• complete：function，可选属性，表示请求完成后的回调函数，不论成功或失败都会执行。

下面是一个基本的请求示例：

wx.request({
  url: 'https://example.com/api/test',
  data: {
    name: 'ChatAI',
    age: 25
  },
  success(res) {
    console.log(res.data)
  }
})

接下来，让我们看看一些常见的 request 请求类型：

GET 请求

GET 请求是向服务器获取数据的一种请求方式，参数通常是查询字符串形式传递给服务器。下面是一个 GET 请求的示例：

wx.request({
  url: 'https://example.com/api/data',
  method: 'GET',
  data: {
    name: 'ChatAI',
    age: 25
  },
  success(res) {
    console.log(res.data)
  }
})

在上面的示例中，请求的 URL 是 https://example.com/api/data，请求方式是 GET，参数是 name 和 age。

POST 请求

POST 请求是向服务器提交数据的一种请求方式，通常将数据放在请求体中传递。下面是一个 POST 请求的示例：

wx.request({
  url: 'https://example.com/api/data',
  method: 'POST',
  data: {
    name: 'ChatAI',
    age: 25
  },
  success(res) {
    console.log(res.data)
  }
})

在上面的示例中，请求的 URL 是 https://example.com/api/data，请求方式是 POST，参数是 name 和 age。

文件上传

小程序中的 request API 还支持文件上传功能。文件上传需要使用 wx.uploadFile(OBJECT) 方法，其中 OBJECT 是一个 Object 类型的参数，表示文件上传的配置项。

示例代码如下：

wx.uploadFile({
  url: 'https://example.com/api/upload',
  filePath: 'path/to/file',
  name: 'file',
  formData: {
    'user': 'ChatAI'
  },
  success(res) {
    console.log(res.data)
  }
})

上述代码中，filePath 参数表示要上传的文件路径，name 参数表示上传文件的名称，formData 参数表示上传的其他表单数据。

总结

以上就是小程序 request 请求的基本使用方法，可以根据自己的需要使用不同的请求类型。熟练掌握 request API 的使用，有助于在小程序开发中更加高效地获取和处理数据。