【php】PHP如何更优雅地调用API接口

Z时代
2024-01-10
分类：技术分享

API接口在各种场景中已经非常普遍使用，通常在PHP后台调用API接口，需要通过Curl库来自己封装，且不说各种充值门槛，还要被各种api接口平台的appKey、appSecret之类的参数困惑，没法统一调用。ThinkPHP官方出品的ThinkAPI服务正是为了解决PHP接口调用的各种麻烦问题。

通过ThinkAPI提供的SDK功能可以以更优雅的方式来调用API接口，首先需要在你的项目里面安装think-api库（适用于任何PHP5.6+项目，没有任何框架要求）。

composer require topthink/think-api

然后就可以调用你需要的接口进行查询和返回数据，支持ThinkAPI所有的API接口，以查询身份证所属地区接口为例：

use thinkapiClient;
$client = new Client("appCode");
$result = $client->idcardIndex()
->withCardno('身份证号码')->request();

idcardIndex方法就是调用了身份证归属地查询接口 withCardno方法则表示传入了cardno参数，如果还需要传入更多的参数则链式调用更多的方法即可，最后通过request方法进行实际调用并返回数据。通过IDE配合的话，你不需要自己记住任何接口方法名和参数方法名，都会有自动提示。

ThinkAPI所有的API调用服务必须设置appCode值（只需要注册一个账号即可获取），用于接口调用的身份认证。如需多次调用的话，建议自己在项目里面封装一个助手函数，例如：

use thinkapiClient;
/**
* API接口调用助手函数
* @return Client
*/
function api(): Client
{
return new Client('yourAppCode');
}
// 调用示例
$result = api()->idcardIndex()
->withCardno('身份证号码')->request();

所有的接口服务和方法都支持IDE自动提示和完成（请务必注意方法大小写必须保持一致），所有的返回数据都是JSON格式，因此基本上不需要文档即可完成接口开发工作。API接口调用中的一些常见问题通过系统的方法封装都可以规避掉，你甚至不需要关心接口是要用GET还是POST，都是系统自动处理的。

SDK把所有接口和参数都封装为一个个独立的方法，你可以像调用一个类的方法一样简单的调用官方支持的任何API接口，也无需再去记住每个接口的参数有哪些。

更详细的用法可以参考：https://docs.topthink.com/think-api
【php】PHP如何更优雅地调用API接口