手把手第七篇：小程序开发中使用网络请求

在上期文章中，我们主要聊了聊如何在小程序中使用 JS 处理内容或样式。本期文章中，我们要学习在小程序中发起一个网络请求，并成功获取请求返回的数据，主要包含了两个方面：

小程序服务器域名的配置
网络请求接口的使用

本期文章属于《手把手系列教学》的第七篇，如果你还不太了解这一系列，可以点击 这里 查看详情。

使用须知

小程序服务器域名的配置

在发起网络请求的时候需要填写接口地址，而小程序出于安全请求，必须是配置了服务器域名的接口地址，才能成功的发起网络请求。那么，以下我们来学习如何进行小程序服务器域名的配置。

服务器域名请在「小程序后台-开发-开发设置-服务器域名」中进行配置，配置时需要注意：

域名只支持 https ；
可以配置端口，如 https://myserver.com:8080，但是配置后只能向 https://myserver.com:8080 发起请求。如果向 https://myserver.com、https://myserver.com:9091 等 URL 请求则会失败；
域名必须经过 ICP 备案；
如果不配置端口。如 https://myserver.com，那么请求的 URL 中也不能包含端口，甚至是默认的 443 端口也不可以。如果向 https://myserver.com:443 请求则会失败。

为了方便讲解，我们直接使用了微信小程序的要求进行讲解，但不要担心，在 FinClip 中，这一切内容都是通用的。

根据上面注意点，我们即可完成小程序服务器域名的配置。接下来，我们使用网络请求接口发起请求并处理返回数据。

使用细节

网络请求接口的使用

小程序中, 发起一个网络请求主要用的接口是 wx.request 。我们可以参考相应的接口文档：

https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html

这个接口主要涉及到以下几块：

请求的地址，头部，及其他参数；
请求的数据；
返回的数据的处理。

请求的地址，头部，及其他参数

我们使用 wx.request ，传入以下参数，完成请求地址与头部等内容的设置：

wx.request({
  url: '<https://mp.finogeeks.com>',
  header: {
    foo: 'bar'
  },
	method: 'GET'
})

// 该参数配置的意思是：通过 GET 方式往 ‘<https://mp.finogeeks.com>’ 发送一个请求，请求都带上 foo：bar

我们通过开发者工具看该请求，可以看到请求相关的配置都会出现在请求的信息中：

请求的数据

通常来说，我们在使用 POST 请求的时候，会携带一些数据，而在小程序中，这些数据是在 data 中配置的，修改一下上面的例子：

wx.request({
  url: '<https://www.apple.com.cn/shop/mcm/tradein-credit>',
  header: {
    foo: 'bar'
  },
  data: {
    ids: 7877
  },
  method: 'POST'
})

// 我们这里把请求方式改成了 'POST', 然后附带的请求的数据（设置了一个 ids）

我们通过开发者工具查看该请求，可以看到这里的请求方式已经发生改变，并且携带了 payload：

处理返回数据

当请求成功后，会返回预期的数据，一般返回的是一个对象（JSON）, 那么我们如何获取并处理返回数据呢，wx.request 接口提供了几个 callback 函数用于处理接口不同情况的返回，分别是：

success（请求成功的回调）；
fail（失败的回调）；
complete（无论成功失败都会执行）。

wx.request({
  url: '<https://www.apple.com.cn/shop/mcm/tradein-credit>',
  header: {
    foo: 'bar'
  },
  data: {
    ids: 7877
  },
  method: 'POST',
	success: function(res) {
		console.log(res, 'success')
	},
	fail: function(res) {
		console.log(res, 'fail')
	},
	complete: function(res) {
		console.log(res, 'complete')
	}
})

该请求是成功返回数据的，所以会按顺序执行 success ， complete 的回调。回调函数打印了返回的数据，控制台能看到如下：

本期教程讲解了在小程序中，如何成功发起网络请求，并获得对应的数据。在下一期文章中，我们将会聊聊如何查看小程序的组件文档，组件的实际使用演示。

敬请期待。