同学们大家好，我是小伊同学，前面我们已经做好了小程序的页面，在开发好了后端的接口之后，我们就需要对前后端进行联通，而在云开发下，这部分内容就是我们今天将要一起学习的——小程序端如何调用云函数。

  在微信小程序中，我们使用wx.request这个API来发送http请求，但对于云开发而言，我们的接口都是云函数，这时我们就需要使用wx.cloud.callFunction这个API来调用云函数。

  wx.cloud.callFunction和第四章我们讲到的API的语法和格式规范一致，使用的基本格式为：花括号中需要填写name属性，属性值为要调用的云函数名称，为必填项。data字段用于填写我们发给服务器的数据，我们可以在花括号中定义我们要发送的变量名称及其值，可以有多条，使用逗号分隔。当然如果我们没有数据要传，这里也可以为空或者不写data这部分。

  其次是success，fail和complete这三个回调函数，他们将分别在api请求成功、失败和完成时执行内部的逻辑。唯一不同的是，这里在success函数中，我们拿到的函数参数中将含有服务器发送给我们的数据，例如这里回调参数为res，那么我们通过res.data就能够访问到服务器返回的数据。这里的数据是指整体数据区，如果服务器返回了电话号码phonnumber字段，那么我们的写法应该是res.data.phonnumber。

  下面我们具体根据某个接口的接口文档填写一个调用云函数api的示例。以登录接口为例，我们拿到的接口文档如左边的表格所示，这里的返回数据我们暂时不考虑，下面我们将它填写到api中，我们将函数名称直接复制过来，复制到name中。然后我们看到输入数据有三个，分别是avatarUrl、gender和nickName，我们在data中进行定义并给定值。最后，我们需要说明一下success和fail函数。大家需要明白两个概念，一个是api调用成功和失败，另一个是服务器请求成功和失败。

  一般，我们看实际的接口文档，在返回数据中，会有关于错误的说明，通常会通过一个数字类型错误码来标识，这个错误码是干什么的呢？就是让前端知道，比如提交的信息不全或者信息比对不一致等等，以便于我们对用户进行提示。对于这类错误，实际上我们请求api是成功的，意思是说我已经成功访问到服务器了，但是服务器请求失败了，因为服务器经过判断发现信息不正确或者不能跟微信服务器获取信息从而导致这个函数并未按照预期方式执行成功。

  因此，这里就会产生两种成功和失败。我们这里的success和fail是指云函数调用的成功和失败，也就是是否成功访问到服务器，在成功访问的前提下，服务器验证和后会告诉我登录成功还是失败，这是该接口功能是否如期完成的成功和失败，也可以说是业务层面的成功和失败，如果成功一般错误码是0，如果失败会给出失败信息。因此我们必须在success函数中判断服务器返回的错误码，以对服务器请求成功和失败分别进行处理。

  我们可以通过调用云函数来和服务器进行数据交换，从而完成小程序的各个功能。学习完这部分内容之后，同学们就可以真正具备开发一个小程序的能力了。在前后端打通之后，同学们同样不要忘记按照之前讲过的方法将代码发布上传哦~

  本节的内容就是这些，如果大家有什么问题，欢迎在文末留言。