《细说PHP》第四版 样章 第23章 自定义PHP接口规范 11

23.6  使用第三方接口服务实例

接供服务的第三方接口平台有很多,现在的项目中也经常用到一些第三方接口,如支付宝、微信、短信、邮件接口等,我们需要借助第三方的能力来实现产品的某些功能。如果自己已经掌握了实现开发接口的方法,应用第三方接口就比较容易了,它们都遵循RESTful风格API的原则,原理是相似的。本节我们来演示通过调用第三方接口获取天气信息,放到自己的网站上的方法。

23.6.1  查找API

用谁的接口,就需要到谁的平台上查找接口的使用文档。例如,想对微信公众平台的服务号进行二次开发,就需要用自己注册的服务号,登录微信公众平台的系统。设置成开发者权限,就可以查看公众平台提供的所有API说明。根据自己的业务需求,再找到对应的API去使用,从而完成开发目标。更多的第三方接口需求,也可以通过搜索引擎找到提供接口的平台。如APIStore(百度旗下)、易源数据、聚合数据等。

23.6.2  查看API文档说明

进入聚合数据平台,网址为https://www.juhe.cn。如果是第一次使用,需要先在该平台注册一个新的账号。聚合数据平台提供了生活常用、车辆服务、金融征信、位置服务、即时通信、应用开发等分类的各种接口。本节仅演示天气接口的使用,用于获取全国各地的天气情况。通过聚合数据平台的导航菜单,在生活常用栏目中找到天气预报接口文档,文档地址为https://www.juhe.cn/docs/api/id/39,如图23-13所示。

20a7e08fb3744306b6b09782bf269e35.png

图23-13  全国天气预报数据接口文档

扫描二维码关注公众号,回复: 7246674 查看本文章

23.6.3  获取接口的key

通过查看文档我们可以看到有个参数 key,这个参数是必填项,用来生成签名进行安全验证。所以我们要先得到这个参数。进入平台的个人中心,通过导航菜单找到“数据中心”下的“我的数据”,如图23-14所示,页面上的“AppKey:3ff5814b0b64c3ee8afc9b2f6c844d75”就是我们需要的key。

622fa266d32c45d08014d27b37a3768b.png

图23-14  找到验证的key

有了参数“key=3ff5814b0b64c3ee8afc9b2f6c844d75”,如果想获取 “北京”的天气情况,可以设置参数“cityname=北京”,其他参数可以使用默认值。接口的请求使用get()方法,接口的地址为“http://v.juhe.cn/weather/index”,组合成一个完整的URL如下所示:

GET http://v.juhe.cn/weather/index?cityname=北京&key=3ff5814b0b64c3ee8afc9b2f6c844d75

   

请求后默认返回JSON格式数据,可以将URL直接复制到浏览的地址栏中,测试接口访问是否正确,执行后结果如图23-15所示。

200c394a68d7427d9ff30cf78502fc84.png

图23-15  使用浏览器测试天气预报接口

23.6.4  使用 PHP 代码请求接口

在PHP程序中,可以使用自己封装的HTTP类中的get()方法,请求天气接口并处理返回数据。新建一个PHP文件weather.php,代码如下所示:

461ee8545e0e40668baaf7dd017d9673.png

上例代码包含了获取支持城市列表、根据城市获取天气预报,包括3小时天气预报的实现和近一周的天气情况。示例代码主要解析了一些常用字段,如果需要完整的或其他未包含的字段,可以自行参考官方的接口进行修改,运行结果如图23-16所示。

c1326d4df1d24adb8a662feeb760bcb8.png

图23-16  使用PHP处理天气接口返回结果

第三方接口平台上有很多比较实用的接口,都可以用同样的方法去试一试。

23.7  小结

本章必须掌握的知识点

Ø 接口的实现流程。

Ø 接口的请求访问流程。

Ø 按口的安全控制规范算法。

Ø RESTful风格API的原则和规范。

Ø 现实WebAPI框架的原理。

Ø 会使用第三方接口。

本章需要了解的内容

Ø 了解接口的几种实现方法。

Ø 接口的应用和优势。

本章需要拓展的内容

Ø 在自定的WebAPI框架中增加表goods的接口。

Ø 通过第三方接口实现支付功能。

Ø 对微信公众账号中的订阅号或服务器进行二次开发。

Ø 设计和开发一款自己的微信小程序。

猜你喜欢

转载自www.cnblogs.com/itxdl/p/11495656.html