按RESTful规范开发API,又有详细的帮助文档,客户端的梦见家里被盗应用就相对容易一些。下面,以PHP作为访问接口的客户端,演示API的应用。在PHP中请求接口需要使用CURL发送HTTP请求,前面我们通过CURL封装了get和post两个HTTP函数,按RESTful API的规范还需要发送put、patch、delete等HTTP请求。我们在客户端创建一个client目录,并新建一个http.php文件,封装一个HTTP类,使用CURL实现所有HTTP的请求方法,代码如下所示:
在HTTP类中封装了get()、post()、put()和delete()这4种请求方法,只要在我们的应用程序中加载本类,并实例化一个HTTP类的对象,就可以直接使用这些方法请求API了。另外,在请求我们定义的接口时,还需要进行安全验证,所以需要在客户端编写一个和API服务器中一样的签名算法,创建一个.php文件,声明一个sign()函数,代码如下所示:
在func.inc.php文件中, 也将token在该文件中声明,用于生成签名,这个算法和API中的签名算法一定要一致。客户端需要的工具都准备完成后,新建一个app.php文件,按照WebAPI文档使用全部的接口,代码如下所示:
请求API后默认返回JSON格式数据,每个接口都是简单的模拟测试,可以在项目中通过表单添加和修改数据,也可将获取的数据遍历后使用HTML和CSS处理显示,本例执行后,输出API的访问结果如图23-12所示。